承認

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

ヒント

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

OAuthアプリのアクセス制限

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

注意

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

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

Prerequisites(前提条件)

  • 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(Organizationへのシングルサインオン)]ダイアログが表示されます。

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

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

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

Workflows内のGitHub接続を削除する

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

Prerequisites(前提条件)

  • Okta Workflows管理者資格情報

Workflows内のGitHub接続を削除する

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

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

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

接続が削除されます。

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

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

サードパーティアクセス

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

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

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

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

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

接続の再作成

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

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

関連項目

GitHubコネクター

Workflows要素

GitHub APIのドキュメント