9.3.5.2. Bitbucket Server OAuth 1 の設定

関連情報

• Bitbucket Server overview
• Download Bitbucket Server
• Bitbucket Server Personal access tokens
• How to generate public key to application link 3rd party applications
• Using AppLinks to link to other applications
• https://access.redhat.com/documentation/en-us/red_hat_codeready_workspaces/2.7/html-single/end-user_guide/index#configuring_bitbucket_authentication_crw.

前提条件

• RH-SSO の外部インストールの管理コンソールで、CodeReady Workspaces に接続することが意図されたユーザーが含まれるレルムを定義します。

  

  View larger image

  

• この realm では、CodeReady Workspaces がユーザーの認証に使用する OIDC クライアントを定義します。以下は、正しい設定のあるクライアントの例です。

  

  View larger image

  
  注記
  • Client Protocol は openid-connect である必要があります。
  • Access Type は public である必要があります。CodeReady Workspaces は public アクセスタイプのみをサポートします。
  • Valid Redirect URIs には、http プロトコルを使用する URL と https を使用する URL の 2 つ以上の CodeReady Workspaces サーバーに関連する URI が含まれる必要があります。これらの URI には CodeReady Workspaces サーバーのベース URL (この後に /* ワイルドカードが続く) が含まれる必要があります。

  • Web Origins には、http プロトコルを使用する URI と https を使用する URI の 2 つ以上の CodeReady Workspaces サーバーに関連する URI が含まれる必要があります。これらの URI には、CodeReady Workspaces サーバーのベース URL (ホストの後はパスがない) が含まれる必要があります。

    URI の数は、インストールされている製品ツールの数によって異なります。

• デフォルトの OpenShift OAuth サポートを使用する CodeReady Workspaces では、ユーザー認証は、OpenShift OAuth と RH-SSO の統合に依存します。これにより、ユーザーは OpenShift ログインで CodeReady Workspaces にログインでき、独自のワークスペースを個人の OpenShift プロジェクトに作成することができます。

  これには、OpenShift アイデンティティープロバイダーを RH-SSO で設定する必要があります。外部 RH-SSO を使用する場合は、アイデンティティープロバイダーを手動で設定します。手順については、以下のいずれかのリンクについての該当する RH-SSO ドキュメントを参照してください:OpenShift 3[OpenShift 3] または OpenShift 4[OpenShift 4]

• 設定済みのアイデンティティープロバイダーでは、Store Tokens および Stored Tokens Readable オプションが有効にされている必要があります。

前提条件

• 管理者としてログインしている。

前提条件

• oc ツールが利用可能である。
• crwctl 管理ツールが利用できる。https://access.redhat.com/documentation/en-us/red_hat_codeready_workspaces/2.7/html-single/installation_guide/index#using-the-crwctl-management-tool_crw を参照してください。

手順

• クラスターで OpenShift アイデンティティープロバイダーを設定します。アイデンティティープロバイダー設定について参照してください。

  ユーザーが OpenShift アイデンティティープロバイダーの設定ステップを省略し、OpenShift クラスターに設定済みのアイデンティティープロバイダーが含まれていない場合、CodeReady Workspaces は HTPasswd アイデンティティープロバイダーの初期 OpenShift ユーザーを作成します。このユーザーの認証情報は、openshift-workspaces namespace にある openshift-oauth-user-credentials シークレットに保存されます。

  OpenShift クラスターおよび CodeReady Workspaces インスタンスにログインするための認証情報を取得します。

  1. OpenShift ユーザー名を取得します。

     $ oc get secret openshift-oauth-user-credentials -n openshift-workspaces -o json | jq -r '.data.user' | base64 -d

     Copy to Clipboard Toggle word wrap

  2. OpenShift ユーザーパスワードを取得します。

     $ oc get secret openshift-oauth-user-credentials -n openshift-workspaces -o json | jq -r '.data.password' | base64 -d

     Copy to Clipboard Toggle word wrap
• OperatorHub または crwctl を使用して CodeReady Workspaces をデプロイする場合は、crwctl server:deploy 仕様についての章を参照してください。OpenShift OAuth はデフォルトで有効にされます。

前提条件

• crwctl 管理ツールが利用できる。https://access.redhat.com/documentation/en-us/red_hat_codeready_workspaces/2.7/html-single/installation_guide/index#using-the-crwctl-management-tool_crw を参照してください。

前提条件

• oc ツールがインストールされている。
• OpenShift で実行している Red Hat CodeReady Workspaces のインスタンス。
• oc ツールを使用して OpenShift クラスターにログインしている。

前提条件

• ユーザーまたは管理者の認証トークン。ユーザーアカウントにバインドされているデータ以外のデータを削除する場合は、admin 権限が必要になります。admin は、CHE_SYSTEM_ADMIN__NAME および CHE_SYSTEM_SUPER__PRIVILEGED__MODE = true カスタムリソース定義を使用して事前に作成され、有効にされる特別な CodeReady Workspaces 管理者アカウントです。

  spec:
   server:
     customCheProperties:
       CHE_SYSTEM_SUPER__PRIVILEGED__MODE: 'true'
       CHE_SYSTEM_ADMIN__NAME: '<admin-name>'

  Copy to Clipboard Toggle word wrap

  必要に応じて、以下のコマンドを使用して admin ユーザーを作成します。

  $ oc patch checluster codeready-workspaces \
    --type merge \
    -p '{ "spec": { "server": {"customCheProperties": {"CHE_SYSTEM_SUPER__PRIVILEGED__MODE": "true"} } }}' \
    -n openshift-workspaces

  Copy to Clipboard Toggle word wrap

  $ oc patch checluster codeready-workspaces \
    --type merge \
    -p '{ "spec": { "server": {"customCheProperties": {"CHE_SYSTEM_ADMIN__NAME": "<admin-name>"} } }}' \
    -n openshift-workspaces

  Copy to Clipboard Toggle word wrap
  注記

  すべてのシステムパーミッションは、CHE_SYSTEM_ADMIN__NAME プロパティーで設定した管理ユーザーに付与されます (デフォルトは admin です)。システムのパーミッションは CodeReady Workspaces サーバーの起動時に付与されます。ユーザーが CodeReady Workspaces ユーザーデータベースにない場合は、最初のユーザーのログイン後に表示されます。

  認証トークンの権限:

  • admin: すべてのユーザーのすべての個人データを削除できます。
  • user: ユーザーに関連するデータのみを削除できます。
• ユーザーまたは管理者が、CodeReady Workspaces がデプロイされた状態で OpenShift クラスターにログインしている。

• ユーザー ID が取得されます。以下のコマンドを使用してユーザー ID を取得します。

  • 現行ユーザーの場合:

    $ curl -X GET \
      --header 'Authorization: Bearer <user-token>' \
      'https://<codeready-<openshift_deployment_name>.<domain_name>>/api/user'

    Copy to Clipboard Toggle word wrap

  • 名前でユーザーを検索するには、以下を実行します。

    $ curl -X GET \
      --header 'Authorization: Bearer <user-token>' \
      'https://<codeready-<openshift_deployment_name>.<domain_name>>/api/user/find?name=<username>'

    Copy to Clipboard Toggle word wrap

  • メールでユーザーを検索するには、以下を実行します。

    $ curl -X GET \
      --header 'Authorization: Bearer <user-token>' \
      'https://<codeready-<openshift_deployment_name>.<domain_name>>/api/user/find?email=<email>'

    Copy to Clipboard Toggle word wrap

    ユーザー ID を取得する例

    この例では、ローカルユーザーの名前として vparfono を使用します。

    $ curl -X GET \
      --header 'Authorization: Bearer <user-token>' \
      'https://che-vp-che.apps.che-dev.x6e0.p1.openshiftapps.com/api/user/find?name=vparfono'

    Copy to Clipboard Toggle word wrap

    ユーザー ID は、curl コマンド出力の下部にあります。

    {
     "name": "vparfono",
     "links": [
       {
    .
    .
    .
       }
     ],
     "email": "vparfono@redhat.com",
     "id": "921b6f33-2657-407e-93a6-fb14cf2329ce"
    }

    Copy to Clipboard Toggle word wrap