Externe OAuth-Provider verwenden

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

    • Jede Client-Anwendung muss bei der Instanz registriert sein, um an der OAuth-Autorisierung teilnehmen zu können.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Hinweis:
    ServiceNow unterstützt nur externe OAuth-Provider bei der Genehmigung von Anfragen von ServiceNow an Drittanbieter-APIs.
    Zum Beispiel möchten Sie unter Umständen einen Drittanbieter-Kalender-Service integrieren, für den OAuth 2.0-Zugriffstoken erforderlich sind, damit die geplanten Ereignisse eines Benutzers abgerufen und neue Ereignisse erstellt werden können. Konfigurieren Sie den Kalender-Service als einen externen OAuth-Provider. Mit dieser Konfiguration können Sie ein Zugriffstoken vom Kalender-Service abrufen und dann das Token verwenden, um Anforderungen von ServiceNow aus an den Service zu senden.

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierung und klicken Sie dann auf Neu.
    2. Klicken Sie auf der Interceptor-Seite auf Verbindung zu einem fremden OAuth-Provider herstellen, und füllen Sie dann das Formular aus.
      Feld Beschreibung
      Name Ein eindeutiger Name, der die Anwendung angibt, auf die zugegriffen werden soll.
      Client-ID Die eindeutige ID der Anwendung. Die Instanz verwendet die Client-ID, wenn ein Zugriffstoken angefordert wird. Sie müssen die Client-ID vom Autorisierungsserver abrufen.
      Client-Secret [Erforderlich] Die gemeinsam genutzte geheime Zeichenfolge, mit der die Instanz und die Anwendung die Kommunikation miteinander autorisieren. Wenn Sie nicht den richtigen Client-Secret eingeben, werden keine Token ausgegeben.
      OAuth-API-Skript Mit dieser Option können Sie auf eine geänderte OAuthUtil-Skripteinbindung verweisen. Kopieren Sie die standardmäßige OAuthUtil-Skripteinbindungsdatei, und benennen Sie sie um, und ändern Sie dann diese Version für bestimmte Anforderungen und Antworten entsprechend Ihrem OAuth-Drittpartei-Provider. Der geänderte Skriptname muss das Präfix OAuthhaben. Siehe OAuthUtil zum Hinzufügen des erforderlichen Textkörperparameters in der richtigen Methode.
      Logo-URL Die URL, die ein Bild enthält, das als Anwendungslogo verwendet werden soll.
      Standardgewährungstyp Typ des Gewährung:
      • Autorisierungscode: Der Code, der dem Client gewährt wird, um ein Zugriffstoken zu erhalten, das dann verwendet wird, um Zugriff auf die Ressource zu erhalten. Wenn Sie diese Option auswählen, benötigen Sie eine Autorisierungs-URL (die URL des Autorisierungsservers).
      • Anmeldeinformationen des Ressourcenbesitzers: Der Benutzername und das Passwort des Benutzers, der versucht, auf die Ressource zuzugreifen.
      • Client-Anmeldeinformationen: Die Client-ID und der Client-Secret, die beide zum Abrufen des Zugriffstokens verwendet werden. Bei dieser Methode werden keine Aktualisierungstoken bereitgestellt.
      • JWT Bearer: Ein Autorisierungsserver validiert ein JWT-Token, das die Weitergabe von Identitäts- und Sicherheitsinformationen zwischen Sicherheitsdomänen ermöglicht.
      • SAML2-Bearer: Generiert die SAML2-Assertion und tauscht die Assertion dann für die Zugriffstoken mit dem Anbieter aus.
        Hinweis:
        Verwenden Sie für die ausgehende Anforderung an SuccessFactors den SAML2-Bearer als standardmäßigen Gewährungstyp.
      Lebensdauer von Aktualisierungstoken Die Lebensdauer des Aktualisierungstokens in Sekunden.
      Zugänglich von Der Anwendungsbereich, von dem aus auf diese Registry zugegriffen werden kann.
      Aktiv Eine Checkbox, die angibt, dass die Anwendungs-Registry aktiv ist.
      Autorisierungs-URL Wenn Sie den Gewährungstyp „Autorisierungscode“ verwenden, die URL des Endpunkts zum Autorisieren des Benutzers. Wenn Sie auf eine andere ServiceNow-Instanz zugreifen, fügen Sie /oauth_auth.do an die URL an.
      Token-URL Die Position des Tokenendpunkts, den die Instanz zum Abrufen und Aktualisieren von Token verwendet. Wenn Sie auf eine andere ServiceNow-Instanz zugreifen, fügen Sie /oauth_token.do an die URL an.
      Umleitungs-URL Der Anwendungsendpunkt, der den Autorisierungscode empfängt. Lassen Sie das Feld leer, damit die Instanz die URL automatisch generiert. Wenn Sie auf eine andere ServiceNow-Instanz zugreifen, fügen Sie /oauth_redirect.do an die URL an.
      Token-Sperr-URL Die Position des Endpunkts, den die Instanz verwendet, um das Token zu widerrufen. Wenn Sie auf eine andere Instanz zugreifen, fügen Sie /oauth_revoke.do an die URL an.
      Anmerkungen Die der Anwendung zuzuordnenden Informationen.
      Eingebettete Listen
      OAuth-Einheitenprofile Die mit dem OAuth-Provider verknüpften Profile. Das Profil enthält den Gewährungstyp. Klicken Sie auf den Profilnamen, um zum Formular „OAuth-Einheitenprofil“ zu gelangen.
      OAuth-Einheitenumfänge Die mit dem OAuth-Provider verknüpften Einheitenumfänge. Der Bereich gibt die Services an, auf die die Anwendung Zugriff hat. Klicken Sie auf den Namen des Bereichs, um zum Formular „OAuth-Einheitenumfang“ zu gelangen.
    3. Klicken Sie auf Absenden. Der Datensatz wird in der Tabelle der Anwendungs-Registrys [oauth_entity] gespeichert.
      Das System erstellt einen Datensatz vom Typ OAuth-Provider in der Tabelle der Anwendungs-Registrys [oauth_entity]. Die Instanz generiert außerdem automatisch ein Standardprofil mit dem angegebenen Gewährungstyp, jedoch ohne Bereiche.

    Nächste Maßnahme

    Sie können zusätzliche Profile erstellen, jeweils mit Bereichen.