GitLab スポークの設定

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む4読むのに数分

    • GitLab でカスタム OAuth アプリケーションを作成し、ServiceNow インスタンスと GitLab を統合します。

    始める前に

    • 統合ハブ サブスクリプションの要求
    • GitLab スポークプラグインのアクティブ化
    • https://gitlab.com/users/sign_in で GitLab のアカウントを作成する
    • 必要なロール：admin

    GitLab トークンの追加

    ServiceNow インスタンスからの要求を認証する GitLab トークンを追加します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > GitLab トークン管理 > GitLab トークン管理.
    2. [新規] をクリックします。
    3. フォームに、次の値を入力します。
      表 : 1. GitLab トークン管理フォーム
      フィールド 説明
      シークレット GitLab のアプリケーション構成中に作成されたシークレット。
      名前 レコードを識別する名前。
      OAuth エンティティ プロファイル GitLab スポークを OAuth プロバイダーとして登録する際に作成される OAuth プロファイル。たとえば、[GitLab OAuth プロファイル] を選択します。
    4. フォームヘッダーを右クリックし、 [保存] をクリックします。
    5. [保護トークンを生成] をクリックします。
      生成されたセキュアなトークンの値が表示されます。
    6. 後で使用するためにセキュアなトークンの値をコピーして記録します。
    7. [更新] をクリックします。

    GitLab アカウントでの OAuth アプリケーションの作成

    GitLab アカウントからカスタム OAuth アプリケーションを作成し、 GitLab スポークで OAuth 2.0 認証を有効にします。

    始める前に

    • GitLab アカウント
    • 必要なロール：GitLab 管理者

    このタスクについて

    GitLabアカウントから、次の手順を完了します。を参照してください。 GitLab アプリケーションを作成および構成する手順のドキュメント。

    手順

    1. GitLab アカウントからアプリケーションを作成します。
    2. [リダイレクト URI] に ServiceNow インスタンス URL を入力します。
      リダイレクト URL の形式は、https://<instance-name>.service-now.com/api/sn_gitlab_spoke/gitlab_oauth_redirect/oauth?secureToken=<Secure-Token> です。

      [<Instance-Name>] を ServiceNow インスタンスの名前で置き換え、[<Secure-Token>] を ServiceNow インスタンスで生成したセキュアなトークンで置き換えます。

    3. 後で使用するために、[アプリケーション ID] および [シークレット] をコピーして記録します。
      これらの詳細は、ServiceNow インスタンスでサードパーティ OAuth プロバイダーとしてアプリケーションを登録する場合に必要です。

    タスクの結果

    GitLab アカウントからカスタム OAuth アプリケーションが作成され、ServiceNow インスタンスとデータ連携できます。

    GitLab スポークの接続の設定

    GitLab 接続を追加して設定し、GitLab スポークで ServiceNow 要求を認証します。

    始める前に

    必要なロール：管理者

    手順

    1. 移動先 プロセス自動化 > フローデザイナー.
    2. [接続] タブをクリックします。
    3. [GitLab] 接続エイリアスを見つけて、[詳細を表示] をクリックします。
    4. [編集] をクリックするか、スポークを初めて設定する場合は、[設定 (Configure)] をクリックします。
    5. [接続] フォームのフィールドに入力します。
      フィールド 説明
      接続名 接続を一意に識別する名前。
      接続 URL 「https://gitlab.com/api」と入力します。
      注:
      オンプレミスサーバーに GitLab をインストールしている場合は、https://<gitlab-hosted-instance>.com/api の形式で URL を入力します。
      OAuth エンティティ名 OAuth エンティティレコードを識別する名前です。
      OAuth クライアント ID GitLab アプリケーションの構成中に作成されたアプリケーション ID。
      OAuth クライアントシークレット GitLab のアプリケーション構成中に作成されたシークレット。
      OAuth リダイレクト URL OAuth コールバックエンドポイント。リダイレクト URL の形式は、https://<instance-name>.service-now.com/api/sn_gitlab_spoke/gitlab_oauth_redirect/oauth?secureToken=<Secure-Token> です。

      [<Instance-Name>] を ServiceNow インスタンスの名前で置き換え、[<Secure-Token>] を ServiceNow インスタンスで生成したセキュアなトークンで置き換えます。
    6. [OAuth トークンを設定して取得] をクリックします。