CloudStorage (Kanal-Einstellungen)

Einstellungen


(1) Zusatzkennungen: Siehe Abschnitt Zusatzkennungen (zentral).

(2) Typ: Hier wählen Sie einen der unterstützten Cloud-Speicher-Anbieter aus.

(3) Application ID, Application secret: Die Zugangsdaten für Ihren Anbieter. Hinweis: Siehe auch Funktion change application secret of CS channel(a,b). Hinweis: Bei manchen Anbietern kann es zusätzliche Felder geben. Die Werte dafür finden Sie beim jeweiligen Anbieter beschrieben.

(4) Anmelden: Für die Typen DropBox, Google drive und MS 365 OneDrive/Sharepoint gibt hier es einen weiteren OAuth2-Dialog. Siehe hierzu Abschnitt OAuth 2.0 (Client).

(5) Legacy Connection: Der Schalter ist bei neuen Kanälen immer inaktiv und muss nicht beachtet werden. Wurde der Kanal vor Version 4.6 angelegt, dann ist dieser Schalter aktiv, um das anzuzeigen (eingeschränkte Funktionalität).

Generelle Anmerkungen zu Cloud-Speicher-Anbietern


Wir möchten im folgenden ein paar Hinweise geben, wie Sie bei Ihrem jeweiligen Anbieter relevante Parameter finden können, bzw. teilweise den Zugriff freigeben können. Bitte behalten Sie dabei im Hinterkopf, dass dies nur eine grobe Hilfestellung ist, Stand April 2018. Aktuelle Details sind immer den entsprechenden Anleitungsseiten des Anbieters zu entnehmen!

Wichtiger Hinweis: Lobster Integration spricht mit dem CloudStorage-Eingangsagenten und CloudStorage-Antwortweg die jeweilige REST-API der Anbieter (wie Amazon AWS, Google Cloud Platform, Microsoft Azure, usw.) über HTTPS an und ist für die Anbindung von Ihrem lokalen Lobster Integration (auf Ihrem System) zu Ihrem Cloud-Anbieter vorgesehen. Ist Lobster Integration dagegen auf der Cloud installiert, z. B. bei Amazon AWS, dann würde sich in diesem Fall die Anbindung von Lobster Integration an Amazon S3 (Amazon Simple Storage Service) über einen Mountpoint, statt über die REST-API empfehlen. Wie solch ein Mountpoint zu erstellen ist, finden Sie in der Dokumentation der jeweiligen Anbieter beschrieben.

Typ AWS S3


  • Stellen Sie sicher, dass Sie über ein AWS-Konto mit Administrator-Rechten verfügen und bei diesem Konto angemeldet sind.

  • Gehen Sie auf https://console.aws.amazon.com/iam/home?#security_credential und erzeugen Sie einen neuen Zugangsschlüssel (Access Key), um Ihre Zugangsschlüssel-ID (Access Key ID) und Ihren geheimen Zugangsschlüssel (Secret Access Key) zu erhalten.

Typ Google Cloud Platform


  • Gehen Sie auf https://cloud.google.com/storage/.

  • Klicken Sie auf "Try it free" (Sie müssen sich evtl. einloggen) und vervollständigen Sie die Registrierung für Google Cloud Storage.

  • Benutzen Sie folgenden Link, um ein neues Google-Konsolen-Projekt zu erstellen: https://console.developers.google.com/iam-admin/projects.

  • Erzeugen Sie ein neues Projekt und geben Sie ihm einen Namen.

  • Tippen Sie "storage" in die Suchleiste oben, wählen Sie "Google Cloud Storage" aus und klicken Sie auf "Aktivieren".

  • Klicken Sie nun auf "Anmeldedaten" in der Leiste links. Wählen Sie dort "Dienstkontoschlüssel" und "JSON" aus, füllen Sie die notwendigen Felder aus und klicken Sie auf "Erstellen".

  • Laden Sie die JSON-Datei herunter und verwenden Sie dort die Felder "client_email", "private_key" und "project_id". Benutzen Sie dabei beim privaten Schlüssel den kompletten String einschließlich "-----BEGIN PRIVATE KEY-----" und "-----END PRIVATE KEY-----".

Typ MS Azure


  • Stellen Sie sicher, dass Sie über ein Microsoft-Azure-Konto mit Administrator-Rechten verfügen und bei diesem Konto angemeldet sind.

  • Erstellen Sie ein neues Speicherkonto (storage account). Der Name der Speicherkontos ist der Name Ihres Kontos.

  • Klicken Sie auf das neu erstellte Speicherkonto. Dort finden Sie Ihren Speicherkontoschlüssel (Access Key).

Typ DropBox


  • Benutzen Sie folgenden Link, um eine neue App zu erstellen (Sie müssen sich evtl. erst einloggen): https://www.dropbox.com/developers/apps/create.

  • Wählen Sie "Dropbox API" aus und dann "Full Dropbox".

  • Geben Sie Ihrer App einen Namen und klicken Sie auf den Button, um die App zu erzeugen.

  • Auf der Folgeseite können Sie die Einstellungen der App ändern. Dort finden Sie auch Ihren App Key (Client ID) und Ihr App Secret (Client Secret).

  • Setzen Sie die Umleitungs-URL (Redirect URI) auf einen Endpoint Ihres Servers, der bereit ist Umleitungen zu empfangen oder auf localhost, um mit dem lokalen Server zu testen.

Typ Google Drive


  • Benutzen Sie folgenden Link und erstellen Sie ein neues Projekt und geben diesem einen Namen (Sie müssen sich evtl. zuerst einloggen): https://console.developers.google.com/iam-admin/projects.

  • Gehen Sie auf die Einstellungen der Projekts.

  • Tippen Sie "drive" in die Suchleiste oben, wählen Sie "Google Drive API" aus und klicken Sie auf "Aktivieren".

  • Klicken Sie nun auf "Anmeldedaten".

  • Gehen Sie nun auf "OAuth-Zustimmungsbildschirm" und füllen Sie die notwendigen Felder aus.

  • Wählen Sie "Webanwendung" und setzen Sie die "Weiterleitungs-URI" auf einen Endpoint Ihres Servers, der bereit ist Umleitungen zu empfangen oder auf localhost, um mit dem lokalen Server zu testen.

  • Nun erhalten Sie Ihre Client-ID und Ihren Clienschlüssel.

Typ MS OneDrive


  • Benutzen Sie diesen Link, um eine neue App zu erzeugen (Sie müssen sich evtl. zuerst einloggen): https://apps.dev.microsoft.com/#/appList.

  • Klicken Sie auf "App hinzufügen" und geben Sie Ihrer App einen Namen.

  • Auf der Folgeseite können Sie die Einstellungen der Apps verändern. Dort finden Sie auch Ihre Anwendungsgeheimnisse.

  • Klicken Sie auf "Plattform hinzufügen" und wählen Sie "Web" aus.

  • Setzen Sie die "Umleitungs-URL" auf einen Endpoint Ihres Servers, der bereit ist Umleitungen zu empfangen oder auf localhost, um mit dem lokalen Server zu testen.

  • Setzen Sie am Ende der Seite unter "Erweiterte Optionen" den Haken bei "Live SDK-Unterstützung".

  • Klicken Sie auf "Speichern".

Typ MS OneDrive Business


  • Bei den folgenden Anweisungen wird davon ausgegangen, dass Sie mit der Active-Directory-Konfiguration von Azure nicht vertraut sind. Wenn doch, können Sie die folgenden Schritte beliebig ändern, so lange Sie eine gültige Client-ID und ein Client-Secret erhalten und die Möglichkeit haben, einen Umleitungs-URI festzulegen.

  • Registrieren Sie eine Office-365-Entwicklerseite, wenn Sie noch keine haben. Sie können eine kostenlose Testversion unter https://portal.microsoftonline.com/Signup/MainSignUp.aspx starten.

  • Als nächstes benötigen Sie einen "Azure Active Directory tenant", falls Sie nicht bereits einen haben. Stellen Sie sicher, dass Sie mit Ihrem "Office 365 tenant" angemeldet sind und gehen Sie zum Admin Center.

  • Öffnen Sie im selben Browser den Link https://account.windowsazure.com/SignUp, um dort ein Microsoft-Azure-Konto zu erstellen.

  • Gehen Sie zu https://manage.windowsazure.com/ und navigieren Sie zu "Active Directory".

  • Ist dort kein Verzeichnis aufgelistet, gehen Sie auf "Directory" und erzeugen Sie mit "Directory/Custom Create" ein neues.

  • Gehen Sie nun auf Ihr Verzeichnis und dort auf "Applications" (Anwendungen).

  • Klicken Sie auf "Add" (Hinzufügen) und wählen Sie "Add an application my organization is developing" (eine Anwendung, die Ihre Organisation entwickelt).

  • Vergeben Sie einen Namen und wählen Sie "Web application" (Webanwendung) und/oder "Web API" und klicken Sie weiter.

  • Eine "Sign-on URL" (Anmelde-URL) ist hier erforderlich, aber nicht relevant. Sie können z. B. https://<ihre_domain>.onmicrosoft.com verwenden, wenn diese URL nicht bereits vergeben ist. Das selbe gilt für die App-ID-URI.

  • Manchmal sagt Azure Ihnen, dass ein Fehler aufgetreten ist und Sie es erneut versuchen müssen. Warten Sie einfach und laden Sie die Seite erneut. Ihre gerade erstellte Anwendung sollte trotzdem vorhanden sein.

  • Wählen Sie Ihre Anwendung aus und gehen Sie auf die Einstellungen.

  • Sie können anpassen, was Ihre Benutzer sehen, wenn Ihre Anwendung nach dem Zugriff fragt.

  • Stellen Sie sicher, dass "Application is Multi-Tenant" auf Ja gestellt ist.

  • Die Client ID ist, was Sie benötigen.

  • Sie müssen möglicherweise "User assignment required to access app" auf Nein stellen.

  • Erzeugen Sie einen neuen Schlüssel unter "keys". Das ist das Client Secret, das Sie ebenfalls benötigen.

  • Die '"Reply URL" ist die Umleitungs-URL. Setzen Sie diese auf einen Endpoint Ihres Servers, der bereit ist Umleitungen zu empfangen oder auf localhost, um mit dem lokalen Server zu testen.

  • Fügen Sie die Anwendung hinzu und vergeben Sie die notwendigen Berechtigungen.

  • Wählen Sie "Office 365 SharePoint Online" aus und fügen Sie die Berechtigungen "Read and write user files" (Benutzerdateien lesen und schreiben) und "Read user files" (Benutzerdateien lesen) hinzu.

  • Stellen Sie sicher, dass Sie am Ende unten auf der Seite speichern.