Einrichten von Box-Zusammenarbeit

Sie können eine Integration in Box ausführen, damit Fallbearbeiter und externe Benutzer Box zum Austauschen von Dokumenten verwenden können.

So richten Sie die Box-Zusammenarbeit ein:

1. Erstellen Sie eine Box-Anwendung für die IBM® Case Manager-Umgebung. Alternativ dazu können Sie eine vorhandene Anwendung modifizieren, die für IBM Content Navigator erstellt wurde.
   1. Gehen Sie zu https://developer.box.com/ und melden Sie sich an.
   2. Klicken Sie im Fenster My Applications auf Create a Box Application.
   3. Wählen Sie Enterprise Application als Anwendungstyp aus.
   4. Wählen Sie OAuth 2.0 with JWT (Server Authentication) als Authentifizierungsmethode aus.
   5. Geben Sie in das Feld Application Name den Namen Ihres IBM Case Manager-Servers ein und klicken Sie dann auf Create Application.
   6. Klicken Sie auf View Application und konfigurieren Sie die folgenden Einstellungen:

      Einstellung	Wert
      Application Access	Enterprise
      Application Scope	Standardeinstellung beibehalten
      Advance Features	Generate User Access Token

   7. Klicken Sie auf Save Application, um Ihre Änderungen zu speichern.
2. Berechtigen Sie die Box-Anwendung für IBM Case Manager zum Zugriff auf Ihren Box-Unternehmensaccount.
   1. Melden Sie sich an Ihrer Box-Anwendung als Benutzer mit Verwaltungsaufgaben an.
   2. Klicken Sie auf Admin Console, klicken Sie auf das Zahnradsymbol und wählen Sie Elite Settings aus.
   3. Notieren Sie auf den Wert des Felds Enterprise ID auf der Registerkarte Account Info. Sie müssen diesen Wert später angeben, wenn Sie das IBM Case Manager-Konfigurationstool ausführen.
   4. Wählen Sie die Registerkarte Apps aus, wechseln Sie zum Abschnitt Custom Applications und klicken Sie auf Authorize New App. Geben Sie im Feld Api Key den client_id-Wert an, der bei der Erstellung der Anwendung angezeigt wurde, und klicken Sie auf Next. Klicken Sie auf Authorize.
3. Generieren Sie ein JSON-Web-Token und ein Box-Server-Token. Weitere Informationen finden Sie in der Dokumentation zu Box unter https://docs.box.com/docs.
   1. Generieren Sie ein RSA-Schlüsselpaar.
      1. Zum Generieren des RSA-Schlüsselpaars auf einem Windows-System laden Sie die Cygwin-Anwendung herunter und führen Sie die folgenden OpenSSL-Befehle über den Cygwin-Terminal aus. Andernfalls geben Sie die Befehle auf einem Linux-System ein.
      2. Generieren Sie einen privaten Schlüssel, indem Sie den folgenden Befehl über die Eingabeaufforderung ausführen: openssl genrsa -aes256 -out private_key.pem 2048. Nachdem Sie eine Kennphrase eingegeben haben, notieren Sie den Wert für die Verwendung im nächsten Schritt.
      3. Generieren Sie einen privaten Schlüssel im PKCS8-Format, indem Sie den folgenden Befehl ausführen: openssl pkcs8 -topk8 -inform pem -in private_key.pem -outform der -nocrypt -out private_pkcs8.der. Geben Sie die Kennphrase an, die Sie im vorherigen Schritt verwendet haben.
      4. Generieren Sie einen öffentlichen Schlüssel, indem Sie den folgenden Befehl ausführen: openssl rsa -pubout -in private_key.pem -out public_key.pem
      5. Suchen Sie die generierten Schlüsseldateien. Suchen Sie die Schlüsseldateien z. B. unterhalb des Cygwin-Installationsverzeichnisses, wie z. B. im Verzeichnis c:\cygwin64\home\Anmeldename.
   2. Übergeben Sie den öffentlichen Schlüssel:
      1. Gehen Sie zu https://developer.box.com/ und melden Sie sich an.
      2. Klicken sie auf die Schaltfläche Edit Application für Ihre Anwendung.
      3. Klicken Sie im Abschnitt Public Key Management auf Add Public Key. Möglicherweise werden Sie aufgefordert, Zwei-Faktor-Authentifizierung zu aktivieren sowie Ihre Mobiltelefonnummer anzugeben, um einen Verifizierungscode zu erhalten. Sie können dieses Feature für Zwei-Faktor-Authentifizierung nach dem Übergeben des öffentlichen Schlüssels inaktivieren.
      4. Kopieren Sie Ihren öffentlichen Schlüssel aus Ihrer Schlüsseldatei und fügen Sie ihn in das Feld Public Key ein. Klicken Sie anschließend auf Verify. Nachdem der Schlüssel verifiziert wurde, klicken Sie auf Save. Ihr öffentlicher Schlüssel und die Schlüssel-ID werden jetzt im Abschnitt Public Key Management angezeigt. Notieren Sie den Wert von Key ID. Sie müssen diesen Wert später angeben, wenn Sie das IBM Case Manager-Konfigurationstool ausführen.
      5. Blättern Sie zum Ende der Seite und klicken Sie auf Save Application.
      6. Inaktivieren Sie die Zwei-Faktor-Authentifizierung. Klicken Sie am Anfang der Seite auf das Zahnradsymbol und wählen Sie Account Settings aus. Klicken Sie auf die Registerkarte Security und wählen Sie das Kontrollkästchen Login verification ab.
4. Konfigurieren Sie eine Verbindung zum Box-Server in Ihrer Entwicklungsumgebung und in Ihrer Produktionsumgebung über das IBM Case Manager-Konfigurationstool oder den Verwaltungsclient.
   • Führen Sie im Konfigurationstool die Task Box-Zusammenarbeit konfigurieren und dann die Task Projektbereich registrieren oder Zielumgebung registrieren aus.
     Tipp: Wählen Sie für neue Profile die Option Box-Zusammenarbeit konfigurieren im Assistenten für neue Profile aus. Fügen Sie für vorhandene Profile die Task Box-Zusammenarbeit konfigurieren nach der Task Plug-in für IBM Case Manager-Verwaltungsclient registrieren, aber vor der Task Projektbereich registrieren oder Zielumgebung registrieren ein.
   • Öffnen Sie im Verwaltungsclient einen Zielobjektspeicher und klicken Sie auf Neue Box-Verbindung.
5. Aktivieren Sie Falltypen für die Unterstützung der Box-Zusammenarbeit. Bearbeiten Sie in Case Manager Builder jeden Falltyp, für den Fallbearbeiter in der Lage sein sollen, mit externen Benutzern in Box zusammenzuarbeiten, und wählen Sie Fallbearbeiter können Box zum Zusammenarbeiten mit externen Benutzern verwenden aus.
6. Damit die Box-Zusammenarbeit in vorhandenen Lösungen verwendet werden kann, die vor der Aktivierung der Box-Zusammenarbeit erstellt wurden, fügen Sie die Aktionen Ordner für Box-Zusammenarbeit hinzufügen, Mitbearbeiter verwalten, Box-Task zuweisen und Box-Kopie manuell hinzu, indem Sie die Lösung in Case Manager Builder bearbeiten. Für Lösungen, die nach der Aktivierung der Box-Zusammenarbeit erstellt werden, werden die Aktionen für Box-Zusammenarbeit standardmäßig in der Dokumentansicht angezeigt.
7. Optional: Aktivieren Sie zusätzliche Box-Integrationsfeatures, die Sie verwenden wollen.

   Feature	Prozedur
   Box als externes Repository	Aktivieren Sie Falltypen zum Unterstützen externer Dokumente. Bearbeiten Sie in Case Manager Builder jeden Falltyp, für den die Benutzer in der Lage sein sollen, dem Fall Dokumente oder Anlagen aus Box hinzuzufügen, und wählen Sie Dokumente und Anlagen aus anderen Repositorys als Fallmanagement-Objektspeichern zulassen aus. Diese Option ist nicht erforderlich, wenn Sie Box nur für die gemeinsame Nutzung von Falldokumenten und Taskanlagen verwenden wollen, die sich in einem IBM FileNet Content Manager- oder IBM Content Manager-Repository befinden.
   Gemeinsame Nutzung von Falldokumenten und Anlagen	Legen Sie das Feld Freigabeadministrator für das Box-Repository manuell fest. Klicken Sie im IBM Content Navigator-Verwaltungstool des Web-Clients auf Repositorys, wählen Sie Ihr Box-Repository aus und legen Sie das Feld Freigabeadministrator fest. Aktivieren Sie Box-Freigabeoption für Ihren IBM Case Manager-Desktop und für jedes IBM FileNet Content Manager- oder IBM Content Manager-Repository, aus dem Sie Dokumente gemeinsam nutzen wollen: IBM Case Manager-Desktop Klicken Sie im IBM Content Navigator-Verwaltungstool auf Desktops und öffnen Sie Ihren IBM Case Manager-Desktop. Aktivieren Sie auf der Registerkarte Allgemein die Option Box-Freigabeservices und wählen Sie das Box-Repository für gemeinsam genutzte Dateien aus. IBM FileNet Content Manager- oder IBM Content Manager-Repository Klicken Sie im IBM Content Navigator-Verwaltungstool auf Repositorys und öffnen Sie jedes IBM FileNet Content Manager- oder IBM Content Manager-Repository. Aktivieren Sie auf der Registerkarte Konfigurationsparameter die Option Optionale Features > Box-Freigabe. Damit Dokumente in vorhandenen Lösungen, die vor IBM Case Manager Version 5.2.1 Fixpack 3 erstellt wurden, gemeinsam genutzt werden können, fügen Sie die Menüaktionen Box-Freigabe und Box-Freigabe löschen manuell hinzu, indem Sie die Lösung in Case Manager Builder bearbeiten. Die Menüaktionen Box-Freigabe und Box-Freigabe löschen werden standardmäßig in der Dokumentansicht angezeigt.

8. Implementieren Sie Ihre Lösung.
9. Konfigurieren Sie SSL auf dem Anwendungsserver, damit Ihre Lösung auf Box zugreifen kann. Weitere Informationen finden Sie in SSL für Box konfigurieren.