{{:icon-owl-96.png?nolink|}} ====== Knowledgebase ► BeeCollect Cloud ► Elemente und Begriffe ====== [[:start|{{ ::icon-home-64.png?nolink|Startseite}}]] [[bcpro:de:knowledgebase|{{ ::icon-owl-64.png?nolink|Zurück zur Knowledgebase}}]] [[bcpro:de:knowledgebase:bc-cloud|{{ ::icon-arrow-left-64.png?nolink|Zurück zur den Artikeln}}]] ===== Core ===== Ein Core ist die Datenbank, welche die Datenelemente einer Organisation enthält. Jede Organisation besitzt genau einen Core. Der Core enthält beliebig viele DataElement-Strukturen, jedes davon jedoch nur genau ein mal. Der Zugriff auf den Core und die darin enthaltenen Datenelemente wird gewährt über zugeordnete ShareKeys. ===== DataElement ===== Ein DataElement repräsentiert die Nutzdaten innerhalb eines Cores. Es wird identifiziert durch einen globalen Schlüssel, welcher die Eindeutigkeit eines DataElements garantiert. Der Zugriff auf das DataElement wird gewährt über zugeordnete ShareKeys. Zusätzlich enthält das DataElement für jeden zugeordneten ShareKey ein Flag, welches gesetzt oder nicht gesetzt sein kann. Darüber kann bei Abfragen sichergestellt werden, dass jeweils nur geänderte DataElements abgerufen werden. Das DataElement hat darüber hinaus ein "Deleted"-Flag, welches es als gelöscht kennzeichnet. Gelöschte Datenelemente besitzen keinen Content, also keine nutzbaren Metadaten. ===== DataElementKey ===== Globaler Schlüssel, welcher ein Datenelement eindeutig identifiziert. Der DataElementKey ist dabei identisch mit dem globalen Schlüssel (XyzInsertS) aus BeeCollect Professional. ===== OrganisationKey ===== Ein OrganisationKey ist eine GUID, welche die jeweilige Organisation eindeutig kennzeichnet. Jede Organisation hat genau einen primären Core zugeordnet, dessen Besitzer sie ist. Nur in diesen Core kann die Organisation Datenelemente hineinladen und Freigaben erteilen. Sie kann jedoch auf weitere Cores Zugriff über ShareKeys haben. Der OrganisationKey wird von Solvatec für die entsprechende Organisation bei der Einrichtung des Zugriffs auf die BeeCollect Cloud erzeugt und dann in der entsprechenden BeeCollect Professional-Datenbank im Modul Einstellungen als "Öffentlicher Schlüssel" eingetragen. ===== OrganisationSecret ===== Das OrganisationSecret ist ein Schlüssel. welcher nur der jeweiligen Organisation bekannt sein darf. Über diesen Schlüssel authentifiziert sich die Organisation als Besitzer des zugeordneten primären Cores. Das OrganisationSecret wird von Solvatec für die entsprechende Organisation bei der Einrichtung des Zugriffs auf die BeeCollect Cloud erzeugt und dann in der entsprechenden BeeCollect Professional-Datenbank im Modul Einstellungen als "Geheimer Schlüssel" eingetragen. **Das OrganisationSecret** darf niemals öffentlich zugänglich sein.** ===== ShareKey ===== Ein ShareKey dient der Authentifizierung des Zugriffs auf Daten eines Cores. Der ShareKey ist assoziiert mit einer ACL (Access Control List), welche die genauen Zugriffsrechte definiert. Ein ShareKey ist dabei immer genau einem Core zugewiesen. Daneben ist er allen Datenelementen innerhalb des Cores zugewiesen, auf die ebenfalls Zugriff gewährt werden soll. Der ShareKey ist weiterhin mit einem OrganisationKey assoziiert. Dadurch wird sichergestellt, dass ShareKeys von keiner anderen als der Organisation verwendet werden können, für die sie erstellt worden sind (gesichert durch die zusätzliche Authentifizierung per OrganisationSecret). ===== AccessToken ===== Ein AccessToken enthält verschlüsselt den OrganisationKey sowie das Gültigkeitsdatum des AccessTokens. Für die meisten Abfragen an die BeeCollect Cloud ist die Angabe eines gültigen AccessTokens erforderlich. Nach Ablauf des Gültigkeitsdatums kann das AccessToken nicht mehr für Abfragen verwendet werden.