Richten Sie die Box-Spoke ein

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer

    • Integrieren Sie Ihre Instanz ServiceNow und die Box-APIs, um die Aktionen der Box-Spoke zu automatisieren. Sie können beispielsweise einen Flow einrichten, der eine Datei in Ihrem Box-Konto entfernt. Wenn Sie die Box-Spoke einrichten, wird dieser Flow automatisiert.

    Vorbereitungen

    • Fordern Sie ein IntegrationHub -Abonnement an.
    • Aktivieren Sie die Box-Spoke.
    • Zugriff auf die Box-Entwicklerkonsole.
    • 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-Konto
    • Anmeldeinformationen des Box-Administrators
    • Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Führen Sie diese Schritte von Ihrem Box-Konto aus. Anweisungen zum Erstellen und Konfigurieren von benutzerdefinierten Anwendungen finden Sie in der Dokumentation zum Box-Entwicklerportal.

    Prozedur

    1. Melden Sie sich bei der Box-Entwicklerkonsolean.
    2. Wählen Sie Neue App erstellen aus.
      Hebt die Schaltfläche „Neue App erstellen“ hervor
    3. Wählen Sie Anwenderdefinierte Appaus.
      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 SieAnwenderdefiniertes Portalaus
    5. Wählen Sie Weiter.
      Das Modal „Anwenderdefinierte App erstellen“ wird angezeigt.
    6. Wählen Sie Anwenderauthentifizierung (OAuth 2.0)aus.
    7. Wählen Sie zum Bestätigen App erstellen aus.
      Sie befinden sich in den Konfigurationseinstellungen Ihrer Anwendung.
    8. Kopieren Sie im Abschnitt „OAuth 2.0-Anmeldeinformationen“ die Client-ID und den geheimen Clientschlüssel.

      Sie benötigen diese Informationen, um die Anwendung als OAuth-Drittpartei in Ihrer Instanz ServiceNow zu registrieren.

    9. Aktivieren Sie im Abschnitt „Anwendungsbereiche“ die Bereichsberechtigungen, die Sie unterstützen möchten.

      Anwendungsbereiche

      Erforderlich für...

      Alle in Box gespeicherten Dateien und Ordner lesen und schreiben

      Aktionen für Dokumentverwaltung, Dokumentfreigabe und Ordnerverwaltung

      Anwender verwalten

      Benutzerverwaltungsaktionen

      Verwalten Sie Gruppen

      Gruppenverwaltungsaktionen

      Verwalten Sie Unternehmenseigenschaften

      Aktionen für Dokumentfreigabe, Gruppenverwaltung und Benutzerverwaltung

      Verwalten Sie Webhooks

      V2-Webhooks werden konfiguriert
    10. Wählen Sie Änderungen speichernaus.

    Konfigurieren Sie einen Verbindungsdatensatz für die Box-Spoke

    Fügen Sie eine Box-Verbindung hinzu, und konfigurieren Sie sie, um ServiceNow -Anforderungen in einer Box-Spoke zu authentifizieren.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren Sie in Ihrer Instanz von ServiceNow zu Alle > Prozessautomatisierung > Workflow-Studio.
    2. Klicken Sie auf die Registerkarte Integrationen.
    3. Unter „Verbindungen“schalten Sie die Option für Ausgehende Verbindungen um, und aktivieren Sie sie.
    4. Suchen Sie den Alias für Box, und klicken Sie auf Details anzeigen.
      • Klicken Sie auf Details anzeigen, um den standardmäßigen Aliasdatensatz für Verbindungen und Anmeldeinformationen zu konfigurieren, der zusammen mit der Box-Spoke bereitgestellt wird.

        Zeigen Sie Details der Box-Verbindung an.

      • Um mehr als einen Box-Spoke-Verbindungsdatensatz zu verwalten, sollten Sie einen neuen untergeordneten Aliasdatensatz erstellen, indem Sie auf Verbindung hinzufügenklicken. 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-Upload-Anmeldeinformationen

      OAuth-Name

      Box-OAuth.

      OAuth-Client-ID

      Die Client-ID der Anwendung. Weitere Informationen finden Sie unter OAuth-Anwendung erstellen.

      OAuth-Client-Geheimnis

      Geheimer Clientschlüssel der Anwendung. Weitere Informationen finden Sie unter OAuth-Anwendung erstellen.

      OAuth-Umleitungs-URL

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

      Konfigurieren Sie die Box-Verbindung.

    6. Klicken Sie auf Verbindung konfigurieren.

    Ergebnisse

    Die Spoke-Verbindung ist konfiguriert und kann verwendet werden.

    Hinweis:
    OAuth-Token laufen nach 30 Tagen ab. Ein Administrator kann das OAuth-Token für die Spoke alle 30 Tage neu 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. Navigieren Sie in Ihrer Instanz von ServiceNow zu Alle > Prozessautomatisierung > Flow Designer.
    2. Wählen Sie die Registerkarte Verbindungen.
    3. Suchen Sie nach dem Box -Verbindungsalias.
    4. Wählen Sie Details anzeigen.
    5. Wählen Sie für die Verbindung die Option OAuth-Token abrufen aus.

    Ergebnisse

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