Richten Sie die Box-Spoke ein

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 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 benutzerdefinierte OAuth-Anwendung von Ihrem Box-Konto, um die OAuth0-Authentifizierung mit der Box-Spoke zu aktivieren.

    Vorbereitungen

    Box-Anforderungen:
    • Box-Konto
    • Box-Administrator-Anmeldeinformationen
    • Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Führen Sie diese Schritte von Ihrem Box-Konto aus. In der Dokumentation zum Box Developer Portal finden Sie Anweisungen zum Erstellen und Konfigurieren benutzerdefinierter Anwendungen.

    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 Benutzerdefinierte App aus.
      Hebt die Option Benutzerdefinierte 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 SieBenutzerdefiniertes Portal aus
    5. Wählen Sie Weiter.
      Das Dialogfeld „Benutzerdefinierte App erstellen“ wird angezeigt.
    6. Wählen Sie Benutzerauthentifizierung (OAuth 2.0) aus.
    7. Wählen Sie zum Bestätigen App erstellen.
      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 ServiceNow -Instanz zu registrieren.

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

      Anwendungsbereiche

      Erforderlich für...

      Lesen und Schreiben aller in Box gespeicherten Dateien und Ordner

      Aktionen für Dokumentverwaltung, Dokumentfreigabe und Ordnerverwaltung

      Benutzer verwalten

      Benutzerverwaltungsaktionen

      Gruppen verwalten

      Gruppenverwaltungsaktionen

      Verwalten Sie Unternehmenseigenschaften

      Aktionen für Dokumentfreigabe, Gruppenverwaltung und Benutzerverwaltung

      Verwalten Sie Webhooks

      V2-Webhooks konfigurieren
    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 ServiceNow zu Alle > Prozessautomatisierung > Flow Designer.
    2. Wählen Sie die Registerkarte Verbindungen aus.
    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ügenaus.

        Hinweis:
        Informationen zur Unterstützung mehrerer Verbindungen über eine Spoke finden Sie unter Unterstützung mehrerer 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

        Anwendungsclient-ID Weitere Informationen finden Sie unter OAuth-Anwendungen erstellen.

        Geheimer OAuth-Schlüssel

        Geheimer Schlüssel des Anwendungsclients. Weitere Informationen finden Sie unter OAuth-Anwendungen erstellen.

        OAuth-Umleitungs-URL

        Die URL in diesem Format:<instance-name> .com/oauth.do.
      3. Bestätigen Sie Ihre Konfiguration.
        • Wählen Sie für eine vorhandene 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 Spoke-OAuth-Token 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 ServiceNow zu Alle > Prozessautomatisierung > Flow Designer.
    2. Wählen Sie die Registerkarte Verbindungen aus.
    3. Suchen Sie nach dem Box- Verbindungsalias.
    4. Wählen Sie Details anzeigen.
    5. Wählen Sie OAuth-Token abrufen für die Verbindung aus.

    Ergebnisse

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