Stellen Sie über OAuth 2.0 eine Verbindung zu einem Git-Provider mit her ServiceNow IDE

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

    • Richten Sie eine OAuth 2.0-Anwendungsregistrierung und -Anmeldeinformationen ein, um über ServiceNow IDEeine Verbindung zu Ihrem Git-Provider herzustellen.

    Konfigurieren Sie eine OAuth 2.0-Anwendungsregistrierung für ServiceNow IDE

    Konfigurieren Sie, wie die Client-ID und das Geheimnis an den OAuth 2.0-Anbieter gesendet werden, der Ihrem Git-Anbieter zugeordnet ist.

    Vorbereitungen

    Erstellen Sie eine OAuth-Anwendung mit Ihrem Git-Provider, und konfigurieren Sie sie für die Weiterleitung an Ihre -Instanz. Verwenden Sie in dieser OAuth-Anwendung Ihre Instanz-URL als Homepage-URL und https:// <instance> /oauth_redirect.do für die Rückruf-URL für die Autorisierung. Repositorys GitHub, GitLab, Bitbucketund Azure werden standardmäßig unterstützt.

    Wichtig:
    Für Azure Repositorys muss die maximale Länge des Felds Client-Geheimnis auf 2048 aktualisiert werden, bevor Sie das Geheimnis hinzufügen.
    1. Navigieren zu Alle > Systemdefinition > Tabellen.
    2. Filtern Sie die Tabelle, indem Sie oauth_entity für das Feld Name eingeben.
    3. Wählen Sie die Tabelle „Anwendungsregistrierungen“ [oauth_entity] aus.
    4. Suchen Sie in der zugehörigen Liste „Spalten“ nach der Spalte Geheimer Clientschlüssel, und geben Sie 2048 als Wert des Attributs Max. Länge ein.
    5. Wählen Sie Aktualisieren.

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Um die OAuth 2.0-Authentifizierung mit ServiceNow IDEzu verwenden, müssen Sie die OAuth-Anwendung registrieren, die Sie bei Ihrem Git-Provider erstellt haben. Befolgen Sie dieses Verfahren, um eine OAuth-Anwendungsregistrierung [oauth_entity] in Ihrer -Instanz zu konfigurieren.

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierung und wählen Sie Neuaus.
    2. Wählen Sie auf der Interceptor-Seite Verbindung mit einem OAuth-Drittpartei-Anbieter herstellenaus.
    3. Füllen Sie die Felder des Formulars aus.

      Weitere Informationen zu Feldern im Formular finden Sie unter Connect to a third-party OAuth provider.

      Tabelle : 1. Anwendungsregistrierungen-Formular
      Feld Beschreibung
      Name Ein eindeutiger Name für die OAuth-Drittparteiverbindung.
      Client-ID Die Client-ID der OAuth-Anwendung in Ihrem Git-Provider.
      Geheimer Clientschlüssel Der geheime Clientschlüssel der OAuth-Anwendung in Ihrem Git-Anbieter.
      OAuth-API-Skript Das Skript, das zum Anpassen der Anforderung und Antwort an den externen OAuth-Anbieter verwendet wird. Wählen Sie je nach Git-Provider eine der folgenden Optionen aus:
      • GitHub: OAuthAPIScriptForGitHub
      • GitLab: OAuthAPIScriptForGitLab
      • Bitbucket: OAuthAPIScriptForBitbucket
      • Azure Repositorys: OauthAPIScriptForAzureRepos
      Hinweis:
      Zur Verwendung anderer Git-Anbieter können Sie diese Skripts als Beispiele verwenden, um ein eigenes OAuth-API-Skript für Ihren OAuth-Anbieter zu erstellen. Der Name des Skripts muss mit „Oauth“ beginnen.
      Standardgewährungstyp Der Standardgewährungstyp, der zum Erstellen des Tokens verwendet wird. Wählen Sie Autorisierungscodeaus.

      Dem Client wird ein Autorisierungscode gewährt, um ein Zugriffstoken abzurufen, mit dem dann Zugriff auf die Ressource erhalten wird.
      Lebensdauer von Aktualisierungstoken Die Zeit in Sekunden, die das Aktualisierungstoken gültig ist.
      Anwendung Der Anwendungsbereich, der diesen Datensatz enthält.
      Zugänglich von Eine Option, um den Zugriff auf die Anwendungsregistrierung aus allen Anwendungsbereichen oder nur aus diesem Bereich zu ermöglichen
      Aktiv Eine Option zum Aktivieren oder Deaktivieren der OAuth-Anwendung.
      Autorisierungs-URL Der OAuth-Autorisierungscode-Endpunkt für Ihre Git-Domäne. Zum Beispiel:
      • GitHub: https://github.com/login/oauth/authorize
      • GitLab: https://gitlab.com/oauth/authorize
      • Bitbucket: https://bitbucket.org/site/oauth2/authorize
      • Azure Repositorys: https://app.vssps.visualstudio.com/oauth2/authorize
      Token-URL Der OAuth-Servertoken-Endpunkt für Ihre Git-Domäne. Zum Beispiel:
      • GitHub: https://github.com/login/oauth/access_token
      • GitLab: https://gitlab.com/oauth/token
      • Bitbucket: https://bitbucket.org/site/oauth2/access_token
      • Azure Repositorys: https://app.vssps.visualstudio.com/oauth2/token
      Umleitungs-URL Der OAuth-Callback-Endpunkt. Wenn leer, generiert die Instanz automatisch den Wert https://.<instance> /oauth_redirect.do
      Gegenseitige Authentifizierung aktivieren Eine Option zur Verwendung der gegenseitigen Authentifizierung. Lassen Sie diese Option deaktiviert, um die Verwendung der gegenseitigen Authentifizierung für die Tokenanforderung und -widerrufung zu deaktivieren.
      Anmeldeinformationen senden Die Art und Weise, wie der OAuth-Client die Client-Anmeldeinformationen in der Anforderung ausfüllt.
      • Wählen Sie für GitHub, GitLaboder BitbucketAls Standardautorisierungsheaderaus.
      • Wählen Sie für Azure Repositorys Im Anforderungstext (Formular URL-codiert)aus.
    4. Wählen Sie Absenden.

    Nächste Maßnahme

    Entwickler, die ServiceNow IDE verwenden, müssen ihre eigenen OAuth 2.0-Anmeldeinformationen konfigurieren.

    Konfigurieren Sie OAuth 2.0-Anmeldeinformationen, um eine Verbindung zu einem Git-Provider mit herzustellen ServiceNow IDE

    Stellen Sie mit OAuth 2.0-Anmeldeinformationen eine Verbindung zu einer Git-Domäne oder einem Git-Repository her, um in der Quellcodeverwaltung für Anwendungen in ServiceNow IDEzu verwalten.

    Vorbereitungen

    • Ein Administrator muss konfigurieren, wie die Client-ID und das Geheimnis an den OAuth 2.0-Anbieter gesendet werden, der Ihrem Git-Provider zugeordnet ist. Weitere Informationen finden Sie unter Konfigurieren Sie eine OAuth 2.0-Anwendungsregistrierung für ServiceNow IDE.
    • Erstellen Sie ein dediziertes Git-Repository für eine Anwendung in einem Git-Provider wie GitHub, GitLab, Bitbucketoder Azure Repositorys.

    Erforderliche Rolle: sn_glider.ide_git_user oder admin

    Prozedur

    1. Navigieren zu Alle > App Development > ServiceNow-IDE.
    2. Öffnen Sie die Befehlspalette mit einem der folgenden Tastenkürzel:
      • Windows: Strg+Umschalt+P
      • Mac: Befehlstaste-Umschalt-P
    3. Geben Sie Git ein: Legen Sie die IDE Git-Anmeldeinformationen fest, und drücken Sie die Eingabetaste.
    4. Wählen Sie im Formular „Neue Git-Anmeldeinformationen“ die Option OAuthaus.
    5. Füllen Sie die Felder des Formulars aus.
      Tabelle : 2. Neues Git-Anmeldeinformationsformular
      Feld Beschreibung
      Git-Repository-URL Die URL zu einem Git-Repository, das Ihren Anmeldeinformationen für den Git-Provider zugeordnet ist.
      Git-Anwendername Ihr Git-Anwendername.
      Wählen Sie ein OAuth-Profil aus Die OAuth 2.0-Anmeldeinformationen für Ihren Git-Provider.

      Das OAuth-Profil wird mit der Anwendungsregistrierung erstellt, die von einem Administrator konfiguriert werden muss.
      Verwenden Sie diese Anmeldeinformationen für alle Repositorys Eine Option zum Verwenden der Anmeldeinformationen für alle Repositorys in der Git-Domäne, die der Git-Repository-URL zugeordnet sind.
    6. Wählen Sie Absenden.

    Ergebnisse

    Wenn Sie einen Git-Befehl zum ersten Mal verwenden, werden Sie aufgefordert, Ihren Anwender vom Git-Anbieter zu autorisieren.

    Nächste Maßnahme

    Nach dem Initialisieren oder Klonen eines Repository können Sie mit der Verwendung der Quellcodeverwaltung beginnen. Weitere Informationen finden Sie unter Verwenden der Quellcodeverwaltung in der ServiceNow IDE.

    Um vorhandene Git-Anmeldeinformationen zu verwalten, verwenden Sie den Befehl Git: Git-Anmeldeinformationen verwalten aus der Befehlspalette.