承認

GitHubカードを初めてフローに追加すると、接続を構成するよう求められます。これにより、GitHubアカウントへの接続、アカウント情報の保存、およびGitHubを含む新しいフローでの接続の再利用を行うことができます。GitHubコネクタはOAuthプロトコルを使用します。

ヒント

複数の接続を作成し、[Connections (接続)]ページから管理することができます。

OAuthアプリのアクセス制限

GitHub組織が作成されるとき、OAuthアプリのアクセス制限がデフォルトで有効になります。組織でこれらの制限が有効な場合、接続を作成し、Workflowsが組織のリソースにアクセスすることを承認するには、制限を無効化する必要があります。「組織でOAuthアプリのアクセス制限を無効化する」を参照してください。

注意

組織でOAuthアプリのアクセス制限が無効な場合、組織の誰かが使用するアプリケーションを承認するとき、組織のプライベートリソースに対してOAuthアプリのアクセスを自動的に承認したことになります。

Workflowsに新しいGitHub接続を作成する

前提条件

  • Okta Workflows管理者資格情報

  • GitHub資格情報

サポートされているスコープ

  • admin:org

  • user

  • repo

  • delete_repo

  • admin:repo_hook

OAuthアプリのスコープ」を参照してください。

手順

  1. 新しい接続を作成する方法は2つあります。

    • GitHubカードをフローに追加し、[New Connection(新規接続)]をクリックします。
    • Workflowsプラットフォームの[Connections(接続)]タブを開きます。[New Connection(新規接続)]をクリックし、[GitHub]をクリックします。
  2. Connection Nickname(接続のニックネーム)]フィールドに、コネクタのリストに表示する表示名を入力します。これは、チームで共有するために複数のGitHub接続の作成を計画している場合に便利です。

  3. Create(作成)]をクリックします。[Single sign-on to your organizations(組織へのシングルサインオン)]ダイアログが表示されます。

  4. 1つまたは複数のGitHub組織の横にある[Authorize(承認)]をクリックし、この接続での使用を認証します。[Continue(続行)]をクリックします。

  5. Authorize Okta Workflows(Okta Workflowsの承認)]ウィンドウが表示されます(Oktaプレビュー組織を使用している場合は[Authorize Okta Preview Workflows(OktaプレビューWorkflowsの承認)])。接続で使用するスコープが一覧表示されます。また、Workflowsがアクセスできる組織も一覧表示されます。組織の横にある[Grant(付与)]をクリックすると、以前に承認していなかった組織に対してアクセスを許可できます。[Authorize workflows-apps(Workflowsアプリの承認)]をクリックします。

  6. GitHubパスワードを入力します。[Confirm password (パスワードの確認)]をクリックします。

ワークフロー内のGitHub接続を削除する

個別のGitHub接続を削除して、GitHubアプリケーションコネクタの承認を解除できます。

前提条件

  • Okta Workflows管理者資格情報

ワークフロー内のGitHub接続を削除する

  1. Okta Workflowsコンソールで、[Connections (接続)]に移動します。

  2. 削除する接続の横に表示される[Delete (削除)]をクリックします。[Delete Connection (接続の削除)]ダイアログが表示されます。

  3. ウィンドウで、[Confirm (確認)]をクリックします。

接続が削除されます。

接続の課題のトラブルシューティング

WorkflowでGithub接続の課題が生じるときは、以下の情報を参照してください。

サードパーティアクセス

組織が表示されない、または組織からデータを受信できない場合は、Workflows Oauthアプリケーションへのサードパーティアクセス権が付与されていることを確認します。

  1. Githubに移動します。
  2. GitHubの右上端で自分のプロフィール写真をクリックし、[Your organizations(自分の組織)]をクリックします。
  3. 組織の横の[Settings(設定)]をクリックします。
  4. 設定の横の[Third-party access(サードパーティアクセス)]をクリックします。
  5. 承認するアプリケーションの横の[Review(レビュー)]をクリックします。
  6. 要求したアプリケーションに関する情報を確認したら、[Grant access(アクセス権を付与)]をクリックします。

アプリケーションの承認とアクセス権の付与

Githubアカウントに関する情報をアプリケーションが取得できるように、Githubアプリケーションを承認します。

  1. [Github] > [Settings(設定)] > [Applications(アプリケーション)] > [Authorized OAuth Apps(承認済みのOAuthアプリ)]に移動します。
  2. アプリケーションを選択します。
  3. [Grant(付与)]を選択してアプリケーションにアクセス権を付与します。

接続の再作成

組織の設定が変更されたときは、組織を承認しなおす必要があります。

  1. 管理コンソールで[Workflow] > [Workflows Console (Workflowsコンソール)]に移動します。
  2. [Connections (接続)]内の[New Connection (新規接続)]をクリックします。
  3. コネクタを選択します。
  4. [Single sign-on to your organizations(組織へのシングルサインオン)]ボックスで[Authorize(承認)]をクリックします。
  5. Continue(続行)]をクリックします。
  6. 資格情報を入力します。
  7. [Sign in(サインイン)]をクリックします。

関連項目

GitHubコネクタ

Okta Workflowsの要素について

GitHub APIドキュメンテーション