3.11. ID および承認の管理

手順

1. https://github.com/settings/applications/new にアクセスします。

2. 以下の値を設定します。

   1. アプリケーション名: <application name>
   2. ホームページ URL: https://<openshift_dev_spaces_fqdn>/
   3. Authorization callback URL: https://<openshift_dev_spaces_fqdn>/api/oauth/callback
3. Register application をクリックします。
4. Generate new client secret をクリックします。
5. GitHub OAuth アプリケーションシークレットを適用する際に使用するために GitHub OAuth クライアント ID をコピーして保存します。
6. GitHub OAuth アプリケーションシークレットを適用する際に使用するために GitHub OAuth クライアントシークレット をコピーして保存します。

手順

1. Secret を準備します。

   kind: Secret
   apiVersion: v1
   metadata:
     name: github-oauth-config
     namespace: openshift-devspaces 1
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: oauth-scm-configuration
     annotations:
       che.eclipse.org/oauth-scm-server: github
       che.eclipse.org/scm-server-endpoint: <github_server_url> 2
       che.eclipse.org/scm-github-disable-subdomain-isolation: 'false' 3
   type: Opaque
   stringData:
     id: <GitHub_OAuth_Client_ID> 4
     secret: <GitHub_OAuth_Client_Secret> 5

   1

   OpenShift Dev Spaces namespace。デフォルトは openshift-devspaces です。

   2

   これは、組織が使用している GitHub 製品によって異なります。GitHub.com または GitHub Enterprise Cloud でリポジトリーをホストする場合は、この行を省略するか、デフォルトの https://github.com を入力します。GitHub Enterprise Server でリポジトリーをホストする場合は、GitHub Enterprise Server の URL を入力します。

   3

   サブドメイン分離 オプションを無効にした GitHub Enterprise Server を使用している場合は、アノテーションを true に設定する必要があります。それ以外の場合は、アノテーションを省略するか、false に設定することができます。

   4

   GitHub OAuth クライアント ID。

   5

   GitHub OAuth クライアントシークレット。

2. シークレットを適用します。

   $ oc apply -f - <<EOF
   <Secret_prepared_in_the_previous_step>
   EOF

3. 出力に Secret が作成されたことを確認します。

手順

1. アバターをクリックして、プロファイル アプリケーション の編集に移動します。
2. Name に OpenShift Dev Spaces を入力します。
3. Redirect URI として https://<openshift_dev_spaces_fqdn>/api/oauth/callback を入力します。
4. Confidential および Expire access tokens のチェックボックスを選択します。
5. Scopes の下で、api、write_repository、および openid のチェックボックスにチェックを入れます。
6. Save application をクリックします。
7. GitLab-authorized アプリケーションシークレットを適用する際に使用するために GitLab アプリケーション ID をコピーして保存します。
8. GitLab-authorized アプリケーションシークレットを適用する際に使用するために GitLab クライアントシークレット をコピーして保存します。

手順

1. Secret を準備します。

   kind: Secret
   apiVersion: v1
   metadata:
     name: gitlab-oauth-config
     namespace: openshift-devspaces 1
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: oauth-scm-configuration
     annotations:
       che.eclipse.org/oauth-scm-server: gitlab
       che.eclipse.org/scm-server-endpoint: <gitlab_server_url> 2
   type: Opaque
   stringData:
     id: <GitLab_Application_ID> 3
     secret: <GitLab_Client_Secret> 4

   1

   OpenShift Dev Spaces namespace。デフォルトは openshift-devspaces です。

   2

   GitLab サーバーの URL です。SAAS バージョンには https://gitlab.com を使用します。

   3

   GitLab アプリケーション ID。

   4

   GitLab クライアントシークレット。

2. シークレットを適用します。

   $ oc apply -f - <<EOF
   <Secret_prepared_in_the_previous_step>
   EOF

3. 出力に Secret が作成されたことを確認します。

手順

1. Administration > Applications > Application links に移動します。
2. Create link を選択します。
3. External application および Incoming を選択します。
4. Redirect URL フィールドに https://<openshift_dev_spaces_fqdn>/api/oauth/callback を入力します。
5. Application permissions で Admin - Write チェックボックスを選択します。
6. Save をクリックします。
7. Bitbucket アプリケーションリンクのシークレットを適用する際に使用するために クライアント ID をコピーして保存します。
8. Bitbucket アプリケーションリンクのシークレットを適用する際に使用するために、クライアントシークレット をコピーして保存します。

手順

1. Secret を準備します。

   kind: Secret
   apiVersion: v1
   metadata:
     name: bitbucket-oauth-config
     namespace: openshift-devspaces 1
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: oauth-scm-configuration
     annotations:
       che.eclipse.org/oauth-scm-server: bitbucket
       che.eclipse.org/scm-server-endpoint: <bitbucket_server_url> 2
   type: Opaque
   stringData:
     id: <Bitbucket_Client_ID> 3
     secret: <Bitbucket_Client_Secret> 4

   1

   OpenShift Dev Spaces namespace。デフォルトは openshift-devspaces です。

   2

   Bitbucket Server の URL。

   3

   Bitbucket クライアント ID。

   4

   Bitbucket クライアントシークレット。

2. シークレットを適用します。

   $ oc apply -f - <<EOF
   <Secret_prepared_in_the_previous_step>
   EOF

3. 出力に Secret が作成されたことを確認します。

手順

1. アバターをクリックして、All workspaces ページに移動します。
2. ワークスペースを選択してクリックします。
3. Settings OAuth consumers Add consumer に移動します。
4. Name に OpenShift Dev Spaces を入力します。
5. Callback URL として https://<openshift_dev_spaces_fqdn>/api/oauth/callback と入力します。
6. Permissions で、Account と Repositories のすべてのチェックボックスをオンにして、Save をクリックします。
7. 追加されたコンシューマーを展開し、Bitbucket OAuth コンシューマーシークレットを適用する際に使用するために キー 値をコピーして保存します。
8. Bitbucket OAuth コンシューマーシークレットを適用する際に使用するために シークレット 値をコピーして保存します。

手順

1. Secret を準備します。

   kind: Secret
   apiVersion: v1
   metadata:
     name: bitbucket-oauth-config
     namespace: openshift-devspaces 1
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: oauth-scm-configuration
     annotations:
       che.eclipse.org/oauth-scm-server: bitbucket
   type: Opaque
   stringData:
     id: <Bitbucket_Oauth_Consumer_Key> 2
     secret: <Bitbucket_Oauth_Consumer_Secret> 3

   1

   OpenShift Dev Spaces namespace。デフォルトは openshift-devspaces です。

   2

   Bitbucket OAuth コンシューマーキー。

   3

   Bitbucket OAuth コンシューマーシークレット。

2. シークレットを適用します。

   $ oc apply -f - <<EOF
   <Secret_prepared_in_the_previous_step>
   EOF

3. 出力に Secret が作成されたことを確認します。

手順

1. コマンドラインでコマンドを実行して、次の手順に必要なファイルを作成し、アプリケーションリンクシークレットを適用するときに使用します。

   $ openssl genrsa -out private.pem 2048 && \
   openssl pkcs8 -topk8 -inform pem -outform pem -nocrypt -in private.pem -out privatepkcs8.pem && \
   cat privatepkcs8.pem | sed 's/-----BEGIN PRIVATE KEY-----//g' | sed 's/-----END PRIVATE KEY-----//g' | tr -d '\n' > privatepkcs8-stripped.pem && \
   openssl rsa -in private.pem -pubout > public.pub && \
   cat public.pub | sed 's/-----BEGIN PUBLIC KEY-----//g' | sed 's/-----END PUBLIC KEY-----//g' | tr -d '\n' > public-stripped.pub && \
   openssl rand -base64 24 > bitbucket-consumer-key && \
   openssl rand -base64 24 > bitbucket-shared-secret

2. Administration Application Links に移動します。
3. URL フィールドに https://<openshift_dev_spaces_fqdn>/ と入力し、Create new link をクリックします。
4. 提供されたアプリケーション URL が一度リダイレクトされました で、この URL を使用する チェックボックスをオンにして、続行 をクリックします。
5. Application Name に OpenShift Dev Spaces を入力します。
6. Application Type として Generic Application を選択します。
7. OpenShift Dev Spaces を Service Provider Name として入力します。
8. bitbucket-consumer-key ファイルの内容を Consumer キー として貼り付けます。
9. bitbucket-shared-secret ファイルの内容を Shared シークレット として貼り付けます。
10. リクエストトークンの URL として <bitbucket_server_url>/plugins/servlet/oauth/request-token と入力します。
11. アクセストークンの URL として <bitbucket_server_url>/plugins/servlet/oauth/access-token と入力します。
12. Authorize URL として <bitbucket_server_url>/plugins/servlet/oauth/authorize と入力します。
13. 受信リンクの作成 チェックボックスをオンにして、続行 をクリックします。
14. bitbucket-consumer-key ファイルの内容を Consumer Key として貼り付けます。
15. コンシューマー名 として OpenShift Dev Spaces を入力します。
16. public-stripped.pub ファイルの内容を 公開鍵 として貼り付け、Continue をクリックします。

手順

1. Secret を準備します。

   kind: Secret
   apiVersion: v1
   metadata:
     name: bitbucket-oauth-config
     namespace: openshift-devspaces 1
     labels:
       app.kubernetes.io/component: oauth-scm-configuration
       app.kubernetes.io/part-of: che.eclipse.org
     annotations:
       che.eclipse.org/oauth-scm-server: bitbucket
       che.eclipse.org/scm-server-endpoint: <bitbucket_server_url> 2
   type: Opaque
   stringData:
     private.key: <Content_of_privatepkcs8-stripped.pem> 3
     consumer.key: <Content_of_bitbucket-consumer-key> 4
     shared_secret: <Content_of_bitbucket-shared-secret> 5

   1

   OpenShift Dev Spaces namespace。デフォルトは openshift-devspaces です。

   2

   Bitbucket Server の URL。

   3

   privatepkcs8-stripped.pem ファイルの内容。

   4

   bitbucket-consumer-key ファイルの内容。

   5

   bitbucket-shared-secret ファイルの内容。

2. シークレットを適用します。

   $ oc apply -f - <<EOF
   <Secret_prepared_in_the_previous_step>
   EOF

3. 出力に Secret が作成されたことを確認します。

手順

1. Secret を準備します。

   kind: Secret
   apiVersion: v1
   metadata:
     name: azure-devops-oauth-config
     namespace: openshift-devspaces1
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: oauth-scm-configuration
     annotations:
       che.eclipse.org/oauth-scm-server: azure-devops
   type: Opaque
   stringData:
     id: <Microsoft_Azure_DevOps_Services_OAuth_App_ID>2
     secret: <Microsoft_Azure_DevOps_Services_OAuth_Client_Secret>3

   1

   OpenShift Dev Spaces namespace。デフォルトは openshift-devspaces です。

   2

   Microsoft Azure DevOps Services OAuth アプリケーション ID。

   3

   Microsoft Azure DevOps Services OAuth クライアントシークレット。

2. シークレットを適用します。

   $ oc apply -f - <<EOF
   <Secret_prepared_in_the_previous_step>
   EOF

3. 出力に Secret が作成されたことを確認します。
4. OpenShift Dev Spaces サーバーコンポーネントのロールアウトが完了するまで待ちます。