Richten Sie die Box-Spoke ein

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 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

    • IntegrationHub-Abonnement anfordern
    • Box-Spoke Plugin aktivieren
    • 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: admin

    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-Entwicklerkonsole an.
    2. Wählen Sie Neue App erstellen aus.
      Hebt die Schaltfläche „Neue App erstellen“ hervor
    3. Wählen Sie Anwenderdefinierte App aus.
      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 Portal aus
    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 erstellenaus.
      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 speichern aus.

    Konfigurieren Sie eine Verbindung für eine 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: admin

    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. Konfigurieren Sie eine Verbindung.
      1. Fügen Sie eine Verbindung hinzu, oder bearbeiten Sie sie.

        • Um eine vorhandene Verbindung einzurichten, wählen Sie Konfigurieren oder Bearbeiten.

        • Um eine neue Verbindung zu erstellen und zu konfigurieren, wählen Sie Verbindung hinzufügen.

        Hinweis:
        Informationen zur Unterstützung mehrerer Verbindungen über eine Spoke finden Sie unter Unterstützt mehrere Verbindungen.
      2. Füllen Sie das Konfigurationsformular 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.

        Geheimer OAuth-Schlüssel

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

        OAuth-Umleitungs-URL

        Die URL in diesem Format:<instance-name> .com/oauth.do.
      3. Bestätigen Sie Ihre Konfiguration.
        • Wählen Sie bei einer vorhandenen Verbindung Bearbeiten und OAuth-Token abrufen aus.
        • Wählen Sie für eine neue Verbindung Konfigurieren und OAuth-Token abrufen aus.
        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: admin

    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.