add start kerberos hub

This commit is contained in:
cedricve
2021-09-30 15:57:04 +02:00
parent 225071d7b0
commit 44cfd480e8
32 changed files with 1575 additions and 153 deletions

View File

Before

Width:  |  Height:  |  Size: 726 KiB

After

Width:  |  Height:  |  Size: 726 KiB

View File

Before

Width:  |  Height:  |  Size: 1.9 MiB

After

Width:  |  Height:  |  Size: 1.9 MiB

View File

Before

Width:  |  Height:  |  Size: 81 KiB

After

Width:  |  Height:  |  Size: 81 KiB

View File

Before

Width:  |  Height:  |  Size: 1.4 MiB

After

Width:  |  Height:  |  Size: 1.4 MiB

View File

Before

Width:  |  Height:  |  Size: 712 KiB

After

Width:  |  Height:  |  Size: 712 KiB

View File

@@ -1,5 +1,5 @@
---
title: "Get Started"
title: "Getting Started"
description: "What to expect from the Kerberos Enterprise agent."
lead: "What to expect from the Kerberos Enterprise agent."
date: 2020-10-06T08:49:31+00:00

View File

Before

Width:  |  Height:  |  Size: 811 KiB

After

Width:  |  Height:  |  Size: 811 KiB

View File

Before

Width:  |  Height:  |  Size: 196 KiB

After

Width:  |  Height:  |  Size: 196 KiB

View File

Before

Width:  |  Height:  |  Size: 304 KiB

After

Width:  |  Height:  |  Size: 304 KiB

View File

Before

Width:  |  Height:  |  Size: 245 KiB

After

Width:  |  Height:  |  Size: 245 KiB

View File

Before

Width:  |  Height:  |  Size: 1.1 MiB

After

Width:  |  Height:  |  Size: 1.1 MiB

View File

Before

Width:  |  Height:  |  Size: 2.8 MiB

After

Width:  |  Height:  |  Size: 2.8 MiB

View File

Before

Width:  |  Height:  |  Size: 1.4 MiB

After

Width:  |  Height:  |  Size: 1.4 MiB

View File

@@ -1,5 +1,5 @@
---
title: "Enterprise"
title: "Hub"
description: ""
lead: ""
date: 2020-10-06T08:49:15+00:00

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 MiB

View File

@@ -1,7 +1,7 @@
---
title: "First things first"
description: "A scalable interface to manage all your agents and sites through a single pane of glass."
lead: "A scalable interface to manage all your agents and sites through a single pane of glass."
description: "A scalable interface to manage all your Kerberos Agents and sites through a single pane of glass."
lead: "A scalable interface to manage all your Kerberos Agents and sites through a single pane of glass."
date: 2020-10-06T08:49:31+00:00
lastmod: 2020-10-06T08:49:31+00:00
draft: false
@@ -13,142 +13,53 @@ weight: 300
toc: true
---
When installing a Kerberos agent inside your local network, it's possible to review your activity by using the agent's web interface. By nature, you will not be able to access the web interface from the cloud (outside your local network). On top of that, the Kerberos agent doesn't come with a consolidated overview. This means that you will need to open multiple web interfaces, one for each connected surveillance camera.
When installing a Kerberos Agent inside your local network, it's possible to review your activity by using the agents' web interface. By all network principles, you will not be able to access the web interface from the internet (outside your local network). On top of that, the Kerberos Agent doesn't come with a consolidated overview. This means that you will need to open multiple web interfaces, one for each Kerberos Agent.
To simplify and resolve all of these challenges, Kerberos Hub was developed.
> [Kerberos Hub](https://app.kerberos.io) is a cloud solution which allows you to have a single overview of all the media recordings generated by your surveillance cameras. It's not a solution for processing your surveillance cameras in the cloud. For processing of your surveillance cameras, a Kerberos agent is used.
> [Kerberos Hub](https://app.kerberos.io) is a web based application which allows you to have a single overview of all your recordings generated by your Kerberos Agents. It's not a solution for processing your video streams in the cloud; that is the responsibility of Kerberos Agents.
A brief list of the key features of Kerberos Hub are:
- Secured storage
- Secured and bring your own storage (through Kerberos Vault)
- Consolidated overview
- Advanced searching
- Machine learning
- Alerts
- Live streaming
- Accounts
- Logging
- Advanced filtering
- Machine learning and bring you own models (through Kerberos Vault)
- Alerts based on detections or Kerberos Agents' status
- Livestreaming (HD/SD)
- Fine-grained access control through account
- Grouping of Kerberos Agents in groups or sites
- Multitenancy
> Checkout [the demo environment](https://app-demo.kerberos.io) to see and feel the Kerberos Hub solution yourself.
{{< figure src="hub-introduction.gif" alt="Kerberos Hub is a single pane of glass for your entire video landscape." caption="Kerberos Hub is a single pane of glass for your entire video landscape." class="stretch">}}
## Architecture
A simplified architecture is found below. In this architecture the Kerberos agents are installed on-premise, next to the surveillance cameras. Once one of the agents recorded something it will send the recording to our [Kerberos Vault](/vault/first-things-first), using the credentials you've defined inside the agent.
A simplified architecture is found below. In this architecture the Kerberos Agents are installed at the edge, next to the video streams. Recordings are being generated by one or more Kerberos Agents, and send to [Kerberos Vault](/vault/first-things-first), using [the account credentials](/vault/accounts) created in Kerberos Vault.
As soon as the recording is succesfully received several engines will be executed, that will further process the recording and extract metadata from it (classification, origin of the surveillance camera, etc). A lot of processing is happening behind the scenes (by what we call microservices).
Once a recording is successfully stored in Kerberos Vault, it integrates with the [Kerberos Hub pipeline](/hub/pipeline). This pipeline will further process the recordings and extract metadata from it (classification, origin of the video stream, resolution, FPS, etc). The pipeline is composed of a couple of microservices, that can be scaled independently.
By using a browser you can navigate to Kerberos Hub, and review all the recordings made by the Kerberos agents. On top of that you will receive more context about the recordings, get notifications, view a livestream and much more.
By using a web browser you can navigate to Kerberos Hub, and review all the recordings made by the Kerberos Agents, the corresponding livestreams and more.
{{< figure src="architecture.svg" alt="Kerberos Hub is composed out of of different microservices." caption="Kerberos Hub is composed out of of different microservices." class="stretch">}}
{{< figure src="architecture.svg" alt="Kerberos Hub is composed out of different microservices." caption="Kerberos Hub is composed out of different microservices." class="stretch">}}
### Public or Private edition
## Saas or self-hosted
They are two different versions of using and deploying Kerberos Hub, we have the public and private dition. What's the difference?
Kerberos Hub is part of the Kerberos Enterprise Suite, and is made available as a SAAS solution for hobbyists (small scale deployments), and self-hosted for enterprise (large scale deployments).
The Public edition of Kerberos Hub, is running all its services in what we often call the public cloud; and to be more specific on AWS and GCP. The Public cloud is mainly built for people who want to have a low cost and small scale VMS in the cloud. It's easy to (un)subscribe to the system, and you can connect your Kerberos agents in a matter of seconds.
### Software as a service (Saas)
On the other hand we also have the private edition, which is available for enterprises. In contrary to the public edition, a customer can deploy the entire Kerberos Hub platform (with all its microservices) where it wants (on-premise or cloud). Both public and private edition are built on Kubernetes, this means that you will need to
have a Kubernetes cluster available at the location you which to install Kerberos Hub.
Kerberos Hub is available as a software as a service made available through [app.kerberos.io](https://app.kerberos.io). This Saas offering is completely controlled by the Kerberos.io team and makes it possible for end-user which would like to connect a couple of Kerberos Agents, or just want to test out the capabilities of the solution.
For more information about the licensing of Kerberos Hub private edition, please get in touch with cedric@verstraeten.io. The licensing model of Kerberos Hub public edition can be found online.
Behind the scenes we use all previously mentioned components such as [Kerberos Vault](/vault/introduction) and Kerberos Hub. This means we are using our own products in production.
## Features
Learn more about [the Saas offering and pricing here](https://kerberos.io/product/hub/).
So you might wonder, what's actually inside the platform? Please find a concrete list of functionalities below, this should give you more insights about how it looks like and what the capabilities are.
### Self-hosted
## Secured storage
Kerberos Hub is also made available though a private edition, which is self-hosted. This means that you or an enterprise can install the entire Kerberos Hub with all related microservices in your own environment, private datacenter or cloud.
Kerberos Hub allows you to store your data in the cloud, and make it available using a secured web interface. This is how it works.
Once you've installed a Kerberos agent, and created an account on [Kerberos Hub](https://cloud.kerberos.io), you will be able to connect both systems together. By entering credentials received from Kerberos Hub, into your Kerberos agent, your media recordings will be send to our cloud storage.
> You can link one or more Kerberos agents to your Kerberos Hub account.
After linking your media recorded by a Kerberos agent will be send to our secure cloud storage, Kerberos Vault. By default our own [Kerberos Vault](/storage/introduction) service is used, however you can install your own [Kerberos Vault](/storage/introduction) and link it to our public cloud. By doing this all the recordings are stored in your own datacenter of choice, and only metadata is stored inside Kerberos Hub.
{{< figure src="deployment-hub-vault.svg" alt="You connect your agents to Kerberos Hub, through Kerberos Vault." caption="You connect your agents to Kerberos Hub, through Kerberos Vault." class="stretch">}}
Once stored your media recordings will be processed by different functions and algorithms to send alerts, apply machine learning and much more.
> Kerberos Hub is much more than a storage service, you get intelligent capabilities as well. Read on to discover more.
## Consolidated overview
Kerberos Hub will group your media recordings (coming from one or more Kerberos agents) into time bundles. We do this to simplify the searching of a specific event. Less data is shown at once, and when needed you can drill down a level deeper to see more details.
{{< figure src="overview.png" alt="The media page gives you an overview of all your recordings." caption="The media page gives you an overview of all your recordings." class="stretch">}}
In a sneak peek you will see how many media recordings were generated during a certain time period, and which Kerberos agents were involved. For example, this might give you an indication of a particular event (more about in the machine learning section).
### Security
Once you're inside your Kerberos Hub account, you will see all the available media recordings of your Kerberos agents in a single interface. So how does this work?
When you open Kerberos Hub we will generate temporary and private links for every media recording within your account. This link includes a random and unique hash, and is only available for a couple of minutes. So this means that your recording cannot be shared afterwards, or the risk someone else accessing that link is minimised.
## Advanced searching
Next to showing all your recordings in one overview, we also give you the capabilities to search for a recording more easily. For example you can search for recordings within a specific time boundary, recordings generated by a specific Kerberos agent, recordings which are marked as important, classified recordings such as pedestrians or animals, and more.
{{< figure src="search.png" alt="Detailed searching across different sites and cameras. Using smart search to look for specific objects." caption="Detailed searching across different sites and cameras. Using smart search to look for specific objects." class="stretch">}}
## Machine learning
With Kerberos Hub you will get far more than just a nice interface for finding back your recordings. When a recording is uploaded to Kerberos Hub, we will execute all kind of algorithms. One of these algorithms is classification. This algorithm is used to classify/recognise all the objects inside your recording. Any human, vehicle or animal in the recording will be labeled.
Next to classifying, the algorithm is also tracing the classified objects. By doing this we can label the recording with the object of interest. For example at the image below you see the traject of a pedestrian walking by (710 pixels).
{{< figure src="ml.png" alt="When running your recordings on our Kerberos Hub, it will be processed by our ML service." caption="When running your recordings on our Kerberos Hub, it will be processed by our ML service." class="stretch">}}
###### {{< figure src="ml2.png" alt="You can filter and drill down into specific media where a classification was detected." caption="You can filter and drill down into specific media where a classification was detected." class="stretch">}}
## Alerts
When a specific event occurred, a notification can be send to one or more channels. A user can compose an event by selecting one or more conditions. Once the event is triggered, a notification is sent to all the enabled channels.
### Alerts
Kerberos Hub supports different types of alerts:
- **Detections**: send a notification if a recording was received from a specific Kerberos agent, within a time range, with a specific classification, etc.
- **Devices**: when one of your Kerberos agents stopped working, a notification can be send.
- **High upload**: when a lot of recordings are generated within a specific period of time, a notification can be send.
{{< figure src="alerts.png" alt="Configure specific scenarios to trigger alerts." caption="Configure specific scenarios to trigger alerts." class="stretch">}}
### Channels
Kerberos Hub supports different types of channels, towards notifications can be send:
- **Browser**: notifications inside the browser (if the used browser supports this).
- **E-mail**: a personal email can be send.
- **Slack**: send a message to a slack channel.
- **Alexa**: send a notification to Alexa skill ([Notify Me](https://www.amazon.com/Thomptronics-Notify-Me/dp/B07BB2FYFS)).
- **Telegram**: send a message to a Telegram channel.
- **Pushbullet**: send a message to a Pushbullet channel.
- **Pushover**: send a message to a Pushover channel.
- **Webhook**: trigger a webhook (POST).
- **IFTTT**: send a message to IFTTT.
- **SMS**: send a text message to a mobile number.
{{< figure src="channels.png" alt="Channels allow you to communicate to external services." caption="Channels allow you to communicate to external services." class="stretch">}}
## Livestreaming
Kerberos Hub allows you to live stream from your Kerberos agents to your Kerberos Hub account.
For Kerberos Open Source a low resolution livestream is made available, this will allow you to see what is happening in front of your surveillance camera in real-time. The stream is shared over MQTT (TCPS) and visualised in the Kerberos Hub webinterface using secure websockets (WSS). No port forwarding needs to be enabled.
{{< figure src="livestream.png" alt="A Kerberos agent will give you access to the livestream, and a HD stream when using the enterprise agent." caption="A Kerberos agent will give you access to the livestream, and a HD stream when using the enterprise agent." class="stretch">}}
For Kerberos Enterprise a HD livestream is made available. The full resolution and FPS is send through a concept called WebRTC. This WebRTC technology, is used my all major conferencing tools such as Zoom, Teams, etc.
## Accounts
It's possible to create multiple accounts (also called subaccounts) within your main account. Their are two different roles:
- Guest: will only see your media recordings. A guest cannot modify, delete or create something.
- Editor: has full access, same permissions as the main account.
{{< figure src="accounts.png" alt="Using accounts you can give external people access." caption="Using accounts you can give external people access." class="stretch">}}
The self-hosted version of Kerberos Hub is a 100% match with the Kerberos Hub we are delivering through a Saas model. The only difference is that for the self-hosted version [requires a license](/hub/license) to be able to consume the application. Read more [about the licensing here](/hub/license).

View File

@@ -1,15 +0,0 @@
---
title: "Get Started"
description: ""
lead: ""
date: 2020-10-06T08:49:31+00:00
lastmod: 2020-10-06T08:49:31+00:00
draft: true
images: []
menu:
hub:
parent: "hub"
weight: 301
toc: true
---

Binary file not shown.

After

Width:  |  Height:  |  Size: 1011 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 MiB

File diff suppressed because one or more lines are too long

After

Width:  |  Height:  |  Size: 246 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.3 MiB

File diff suppressed because one or more lines are too long

After

Width:  |  Height:  |  Size: 279 KiB

View File

@@ -0,0 +1,112 @@
---
title: "Getting started"
description: "Features you don't want to build yourself"
lead: "Features you don't want to build yourself"
date: 2020-10-06T08:49:31+00:00
lastmod: 2020-10-06T08:49:31+00:00
draft: false
images: []
menu:
hub:
parent: "hub"
weight: 300
toc: true
---
You might wonder what is inside the Kerberos Hub solution? We'll provide you a concrete list of functionalities below, this should give you more insights about how Kerberos Hub looks like and what the capabilities are.
## Secured storage
Kerberos Hub allows you to store your data in the cloud, and make it available using a secured web interface. This is how it works.
Once you've installed a Kerberos agent, and created an account on [Kerberos Hub](https://cloud.kerberos.io), you will be able to connect both systems together. By entering credentials received from Kerberos Hub, into your Kerberos agent, your media recordings will be send to our cloud storage.
> You can link one or more Kerberos agents to your Kerberos Hub account.
After linking your media recorded by a Kerberos agent will be send to our secure cloud storage, Kerberos Vault. By default our own [Kerberos Vault](/storage/introduction) service is used, however you can install your own [Kerberos Vault](/storage/introduction) and link it to our public cloud. By doing this all the recordings are stored in your own datacenter of choice, and only metadata is stored inside Kerberos Hub.
{{< figure src="deployment-hub-vault.svg" alt="You connect your agents to Kerberos Hub, through Kerberos Vault." caption="You connect your agents to Kerberos Hub, through Kerberos Vault." class="stretch">}}
Once stored your media recordings will be processed by different functions and algorithms to send alerts, apply machine learning and much more.
> Kerberos Hub is much more than a storage service, you get intelligent capabilities as well. Read on to discover more.
## Consolidated overview
Kerberos Hub will group your media recordings (coming from one or more Kerberos agents) into time bundles. We do this to simplify the searching of a specific event. Less data is shown at once, and when needed you can drill down a level deeper to see more details.
{{< figure src="overview.png" alt="The media page gives you an overview of all your recordings." caption="The media page gives you an overview of all your recordings." class="stretch">}}
In a sneak peek you will see how many media recordings were generated during a certain time period, and which Kerberos agents were involved. For example, this might give you an indication of a particular event (more about in the machine learning section).
### Security
Once you're inside your Kerberos Hub account, you will see all the available media recordings of your Kerberos agents in a single interface. So how does this work?
When you open Kerberos Hub we will generate temporary and private links for every media recording within your account. This link includes a random and unique hash, and is only available for a couple of minutes. So this means that your recording cannot be shared afterwards, or the risk someone else accessing that link is minimised.
## Advanced searching
Next to showing all your recordings in one overview, we also give you the capabilities to search for a recording more easily. For example you can search for recordings within a specific time boundary, recordings generated by a specific Kerberos agent, recordings which are marked as important, classified recordings such as pedestrians or animals, and more.
{{< figure src="search.png" alt="Detailed searching across different sites and cameras. Using smart search to look for specific objects." caption="Detailed searching across different sites and cameras. Using smart search to look for specific objects." class="stretch">}}
## Machine learning
With Kerberos Hub you will get far more than just a nice interface for finding back your recordings. When a recording is uploaded to Kerberos Hub, we will execute all kind of algorithms. One of these algorithms is classification. This algorithm is used to classify/recognise all the objects inside your recording. Any human, vehicle or animal in the recording will be labeled.
Next to classifying, the algorithm is also tracing the classified objects. By doing this we can label the recording with the object of interest. For example at the image below you see the traject of a pedestrian walking by (710 pixels).
{{< figure src="ml.png" alt="When running your recordings on our Kerberos Hub, it will be processed by our ML service." caption="When running your recordings on our Kerberos Hub, it will be processed by our ML service." class="stretch">}}
###### {{< figure src="ml2.png" alt="You can filter and drill down into specific media where a classification was detected." caption="You can filter and drill down into specific media where a classification was detected." class="stretch">}}
## Alerts
When a specific event occurred, a notification can be send to one or more channels. A user can compose an event by selecting one or more conditions. Once the event is triggered, a notification is sent to all the enabled channels.
### Alerts
Kerberos Hub supports different types of alerts:
- **Detections**: send a notification if a recording was received from a specific Kerberos agent, within a time range, with a specific classification, etc.
- **Devices**: when one of your Kerberos agents stopped working, a notification can be send.
- **High upload**: when a lot of recordings are generated within a specific period of time, a notification can be send.
{{< figure src="alerts.png" alt="Configure specific scenarios to trigger alerts." caption="Configure specific scenarios to trigger alerts." class="stretch">}}
### Channels
Kerberos Hub supports different types of channels, towards notifications can be send:
- **Browser**: notifications inside the browser (if the used browser supports this).
- **E-mail**: a personal email can be send.
- **Slack**: send a message to a slack channel.
- **Alexa**: send a notification to Alexa skill ([Notify Me](https://www.amazon.com/Thomptronics-Notify-Me/dp/B07BB2FYFS)).
- **Telegram**: send a message to a Telegram channel.
- **Pushbullet**: send a message to a Pushbullet channel.
- **Pushover**: send a message to a Pushover channel.
- **Webhook**: trigger a webhook (POST).
- **IFTTT**: send a message to IFTTT.
- **SMS**: send a text message to a mobile number.
{{< figure src="channels.png" alt="Channels allow you to communicate to external services." caption="Channels allow you to communicate to external services." class="stretch">}}
## Livestreaming
Kerberos Hub allows you to live stream from your Kerberos agents to your Kerberos Hub account.
For Kerberos Open Source a low resolution livestream is made available, this will allow you to see what is happening in front of your surveillance camera in real-time. The stream is shared over MQTT (TCPS) and visualised in the Kerberos Hub webinterface using secure websockets (WSS). No port forwarding needs to be enabled.
{{< figure src="livestream.png" alt="A Kerberos agent will give you access to the livestream, and a HD stream when using the enterprise agent." caption="A Kerberos agent will give you access to the livestream, and a HD stream when using the enterprise agent." class="stretch">}}
For Kerberos Enterprise a HD livestream is made available. The full resolution and FPS is send through a concept called WebRTC. This WebRTC technology, is used my all major conferencing tools such as Zoom, Teams, etc.
## Accounts
It's possible to create multiple accounts (also called subaccounts) within your main account. Their are two different roles:
- Guest: will only see your media recordings. A guest cannot modify, delete or create something.
- Editor: has full access, same permissions as the main account.
{{< figure src="accounts.png" alt="Using accounts you can give external people access." caption="Using accounts you can give external people access." class="stretch">}}

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.3 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.5 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.6 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 MiB

View File

@@ -1,15 +1,16 @@
---
title: "Installation"
description: ""
lead: ""
description: "Installing Kerberos Hub wherever you want."
lead: "Installing Kerberos Hub wherever you want."
date: 2020-10-06T08:49:31+00:00
lastmod: 2020-10-06T08:49:31+00:00
draft: true
draft: false
images: []
menu:
hub:
parent: "hub"
weight: 302
weight: 300
toc: true
---

View File

@@ -0,0 +1,16 @@
---
title: "License"
description: "A series of microservices to bring the scale you are looking for."
lead: "A series of microservices to bring the scale you are looking for."
date: 2020-10-06T08:49:31+00:00
lastmod: 2020-10-06T08:49:31+00:00
draft: false
images: []
menu:
hub:
parent: "hub"
weight: 300
toc: true
---

View File

@@ -0,0 +1,16 @@
---
title: "Pipeline"
description: "A series of microservices to bring the scale you are looking for."
lead: "A series of microservices to bring the scale you are looking for."
date: 2020-10-06T08:49:31+00:00
lastmod: 2020-10-06T08:49:31+00:00
draft: false
images: []
menu:
hub:
parent: "hub"
weight: 300
toc: true
---

View File

@@ -1,15 +0,0 @@
---
title: "Releases"
description: ""
lead: ""
date: 2020-10-06T08:49:31+00:00
lastmod: 2020-10-06T08:49:31+00:00
draft: true
images: []
menu:
hub:
parent: "hub"
weight: 303
toc: true
---