Richten Sie die Box-Spoke ein

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

    • Integrieren Sie Ihr ServiceNow Instanz und Box-APIs zur Automatisierung der Box-Spoke-Aktionen. Sie können beispielsweise einen Flow einrichten, der eine Datei in Ihrem Box-Account entfernt. Wenn Sie die Box-Spoke einrichten, wird dieser Flow automatisiert.

    Vorbereitungen

    • Fordern Sie an IntegrationHub Abonnement.
    • Aktivieren Sie Box-Spoke.
    • Zugriff auf die Konsole des Box-Entwicklers.
    • Erforderliche Rolle: admin.

    Erstellen Sie eine OAuth-Anwendung

    Erstellen Sie eine anwenderdefinierte OAuth-Anwendung von Ihrem Box-Konto, um die OAuth0-Authentifizierung mit der Box-Spoke zu aktivieren.

    Vorbereitungen

    Box-Anforderungen:
    • Box-Account
    • Anmeldeinformationen für Box-Administrator
    • Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Führen Sie diese Schritte über Ihren Box-Account aus. Siehe Box-Entwicklerportal Dokumentation für Anweisungen zum Erstellen und Konfigurieren anwenderdefinierter Anwendungen.

    Prozedur

    1. Melden Sie sich bei an Box-Entwicklerkonsole .
    2. Wählen Sie Aus Erstellen Sie Eine Neue App .
      Betont die Schaltfläche „neue App erstellen“
    3. Wählen Sie Aus Anwenderdefinierte App .
      Hebt die Option „Anwenderdefinierte App“ hervor
    4. Füllen Sie das Formular aus.

      Feld

      Wert

      App-Name

      Box-App

      Beschreibung (optional)

      Lassen Sie dieses Feld leer

      Zweck

      Wählen Sie Aus Anwenderdefiniertes Portal

    5. Wählen Sie Weiter.
      Das Modal „Anwenderdefinierte App erstellen“ wird angezeigt.
    6. Wählen Sie Aus Anwenderauthentifizierung (OAuth 2,0) .
    7. Wählen Sie zum Bestätigen aus Erstellen Sie Eine App .
      Sie befinden sich in den Konfigurationseinstellungen Ihrer Anwendung.
    8. Kopieren Sie im Abschnitt „OAuth 2,0-Anmeldeinformationen“ die Client-ID und das geheime Clientgeheimnis.

      Sie benötigen diese Informationen, um die Anwendung als OAuth-Drittanbieter auf Ihrem zu registrieren ServiceNow Instanz.

    9. Aktivieren Sie im Abschnitt Anwendungsbereiche die Umfangsberechtigungen, die Sie unterstützen möchten.

      Anwendungsbereiche

      Erforderlich für...

      Lesen und schreiben Sie alle in Box gespeicherten Dateien und Ordner

      Aktionen für Dokumentverwaltung, Dokumentfreigabe und Ordnerverwaltung

      Anwender verwalten

      Anwenderverwaltungsaktionen

      Verwalten Sie Gruppen

      Gruppenverwaltungsaktionen

      Verwalten Sie Enterprise-Eigenschaften

      Aktionen für Dokumentfreigabe, Gruppenverwaltung und Anwenderverwaltung

      Verwalten Sie Webhooks

      V2-Webhooks werden konfiguriert
    10. Wählen Sie Aus Speichern Sie Die Änderungen .

    Konfigurieren Sie einen Verbindungsdatensatz für die Box-Spoke

    Fügen Sie eine Box-Verbindung zur Authentifizierung hinzu, und konfigurieren Sie sie ServiceNow Anforderungen in einer Box-Spoke.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. In Ihrem ServiceNow Instanz, navigieren Sie zu Alle > Prozessautomatisierung > Workflow-Studioan.
    2. Klicken Sie auf die Registerkarte Integrationen.
    3. Unter Verbindungen , Umschalten und aktivieren Ausgehend Verbindungen.
    4. Suchen Sie den Alias für Feld Und klicken Sie auf Details Anzeigen .
      • Klicken Sie auf, um den Standarddatensatz für Alias für Verbindungen und Anmeldeinformationen zu konfigurieren, der zusammen mit der Box-Spoke geliefert wird Details Anzeigen .

        Zeigen Sie Details der Box-Verbindung an.

      • Um mehr als einen Box-Spoke-Verbindungsdatensatz zu verwalten, sollten Sie einen neuen untergeordneten Alias-Datensatz erstellen, indem Sie auf klicken Verbindung Hinzufügen . Weitere Informationen zur Verwendung mehrerer Verbindungen finden Sie unter Unterstützt mehrere Verbindungen.

      Wenn Sie die Spoke zum ersten Mal konfigurieren, klicken Sie auf Konfigurieren . Klicken Sie andernfalls auf Bearbeiten .

      Konfigurieren Sie die Box-Verbindung.

    5. Füllen Sie diese Werte im Formular aus.

      Feld

      Wert

      Verbindungsname

      Feld .

      Verbindungs-URL

      Die Instanz-URL in diesem Format: <provider-domain-name>.net .

      Anmeldeinformationsname

      Box – Anmeldeinformationen Hochladen .

      OAuth-Name

      Box-OAuth .

      OAuth-Client-ID

      Die Anwendungsclient-ID. Weitere Informationen finden Sie unter Erstellen Sie eine OAuth-Anwendung .

      OAuth-Client-Geheimnis

      Das Geheimnis des Anwendungsclients. Weitere Informationen finden Sie unter Erstellen Sie eine OAuth-Anwendung .

      OAuth-Umleitungs-URL

      Die URL in diesem Format: https://<ServiceNow-instance-name>.service-now.com/oauth_redirect.do . Ersetzen <ServiceNow-instance-name> Mit ServiceNow Instanzname.

      Konfigurieren Sie die Box-Verbindung.

    6. Klicken Sie Auf Konfigurieren Sie Die Verbindung .

    Ergebnisse

    Die Spoke-Verbindung ist konfiguriert und kann verwendet werden.

    Hinweis:
    OAuth-Token laufen nach 30 Tagen ab. Ein Administrator kann das Spoke-OAuth-Token alle 30 Tage erneut generieren.

    Generieren Sie das Box-OAuth-Token erneut

    Generieren Sie das Box-OAuth-Token erneut, wenn dieses abgelaufen ist. Das OAuth-Token für die Box-Spoke läuft alle 30 Tage ab.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. In Ihrem ServiceNow Instanz, navigieren Sie zu Alle > Prozessautomatisierung > Flow Designeran.
    2. Wählen Sie aus Verbindungen Registerkarte.
    3. Suchen Sie nach Feld Verbindungsalias.
    4. Wählen Sie Details anzeigen.
    5. Wählen Sie Aus OAuth-Token abrufen Für die Verbindung.

    Ergebnisse

    Die Box-Spoke erhält ein neues OAuth-Zugriffstoken. Sie läuft in 30 Tagen ab.

    Integrieren Sie die ServiceNow-Instanz mit dem JWT-Bearer-Gewährungstyp

    Richten Sie einen OAuth-Provider mit dem JWT-Bearer-Gewährungstyp ein, um Ihren zu integrieren ServiceNow Instanz mit Box.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Führen Sie die Schritte am Kastenende aus
      1. Melden Sie sich für an Box-Entwickler-Account .
      2. Auf der Entwicklerkonsole , Wählen Sie aus Anwenderdefinierte App .
      3. Bestätigen Sie, dass die Authentifizierungsmethode OAuth 2,0 mit JWT (Serverauthentifizierung) ist.
      4. Geben Sie einen eindeutigen Namen für die App ein, und erstellen Sie die App.
      5. Zeigen Sie die App an.
      6. Kopieren Sie unter OAuth 2,0-Anmeldeinformationen die Client-ID und das geheime Clientgeheimnis.
      7. Erstellen Sie einen neuen Schlüsselspeicher, und exportieren Sie einen öffentlichen Schlüssel aus diesem in BOX.
      8. Notieren Sie sich die EnterpriseID unter den App-Einstellungen.
      9. Navigieren zu Meine Apps > <App Name> > Allgemein > Zur Autorisierung übermittelnan.
      10. Wählen Sie oben in der Administratorkonsole Ihren Accountnamen aus.
      11. Erstellen Sie in Ihrem Account einen Ordner, und laden Sie eine Textdatei hoch.
    2. Führen Sie die Schritte im aus ServiceNow Instanzende
      1. Navigieren zu Systemdefinition > Zertifikate > Neu > Typ > Lageran.
      2. Hängen Sie das Schlüsselspeicher-Zertifikat an.
      3. Konfigurieren Sie einen JWT-Signaturschlüssel, indem Sie zu navigieren System-OAuth > JWT-Schlüssel > Neuan.
      4. Erstellen Sie einen OAuth-Anwendungsregistrierungseintrag, indem Sie zu navigieren System-OAuth > Applikationsregistrierung > Neu > Verbindung zu einem fremden OAuth-Provider herstellen > Standardgewährungstyp (JWT-Bearer)an.
      5. Ordnen Sie unter dem OAuth-Entitätsprofil (oauth_Entity_Profile) den erstellten „jwt-Provider“ zu.
      6. Erstellen Sie eine REST-Nachricht.
      7. Wählen Sie in der REST-Nachricht die Option aus OAuth-Token abrufen Um das Zugriffstoken abzurufen.
      8. Wechseln Sie zur Methode „Standard-GET“, und klicken Sie auf „Test“.
      9. Geben Sie am Ende DES FELDS den Ordner und die Datei frei.