> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Okta での Passport の設定

> Iru Endpoint で macOS ログインとパスワード同期のために Okta を使用した Passport を設定します。Okta のアプリ統合と認証設定を構成します。

<Callout icon="apple" color="#B84A7A" iconType="regular">このガイドは Mac コンピュータに適用されます</Callout>

### Okta を使用した Passport について

Okta を使用した Passport により、ユーザーは個別のローカルパスワードではなく、Okta の資格情報を使用して Mac コンピュータにログインできます。Passport は Okta と macOS のログインを接続します。

### 仕組み

Passport は Okta 組織と統合し、macOS のログイン画面でユーザーを認証します。ユーザーが Okta の資格情報を入力すると、Passport は Okta テナントに照らしてそれを検証し、それに応じてローカルの Mac ユーザーアカウントを作成または更新します。

<Tabs>
  <Tab title="Okta">
    ### Okta アプリケーションの設定

    Passport Library Item を設定する際には、**Client ID** と **IDプロバイダーのURL** が必要です。Okta では、クライアント識別子が **Application ID** と表示される場合があります。以下の手順を使用して OIDC アプリを設定し、必要な情報を収集します。

    <Steps>
      <Step title="アプリケーションにアクセスする">
        Okta 管理コンソールの左側のメニューペインで Applications セクションを展開し、**アプリケーション** を選択します。
      </Step>

      <Step title="アプリ統合を作成する">
        **Create App Integration** を選択します。
      </Step>

      <Step title="サインイン方法を選択する">
        **Sign-in method** で、**OIDC - OpenID Connect** を選択します。
      </Step>

      <Step title="アプリケーションの種類を選択する">
        Application Type で、**Native Application** を選択します。
      </Step>

      <Step title="次の手順に進む">
        **次へ** を選択します。
      </Step>

      <Step title="アプリ名を入力する">
        **App integration name** フィールドに、*Iru Passport* などの名前を入力します。
      </Step>

      <Step title="Grant type を設定する">
        **Grant type** セクションで、**Refresh Token** のチェックボックスが選択されていないことを確認します。Okta のパスワードが変更された場合に、ログイン中のユーザーに Mac のパスワードを更新するよう Passport がプロンプトを表示するには、このオプションをオフにする必要があります。

        <Note>
          ユーザーがパスワード更新のプロンプトを受け取るには、Passport Library Item の **Store user password** 設定を **Securely store password** に設定する必要があります。
        </Note>
      </Step>

      <Step title="OIE を使用している場合は Advanced オプションにアクセスする">
        Okta Identity Engine を使用している場合は、**Advanced** を選択して追加のオプションを表示します。
      </Step>

      <Step title="Resource Owner Password を選択する">
        **Other grants** セクションで、**Resource Owner Password** のチェックボックスを選択します。

        <Note>
          Okta インスタンスがまだ Classic から Okta Identity Engine（OIE とも呼ばれます）に更新されていない場合、**Interaction Code** の Grant type やその他のオプションは表示されません。
        </Note>
      </Step>

      <Step title="リダイレクト URI を追加する">
        **Sign-in redirect URIs** セクションで、**Add URI** を選択します。
      </Step>

      <Step title="リダイレクト URI を入力する">
        表示された新しいフィールドに、次のように入力します。

        ```
        https://localhost.redirect
        ```

        <Note>
          Passport Library Item の 認証モード セクションの Redirect URI フィールドにも、同じサインインリダイレクト URI を使用する必要があります。
        </Note>

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-signin-redirect-uris.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=2f02825f884717f16b0ef50943e3e4ab" alt="Passport 用の Okta の Sign-in redirect URIs" width="1598" height="404" data-path="assets/media/images/iru-okta-passport-signin-redirect-uris.png" />
        </Frame>
      </Step>

      <Step title="割り当てを設定する">
        Assignments セクションで、アプリ統合を組織内の全員に割り当てるか、選択したグループのみに割り当てるか、アプリの作成後まで割り当てをスキップするかを選択します。
      </Step>

      <Step title="設定を保存する">
        **保存** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-app-assignments.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=870954ae75b1b2502767f449ffaf880e" alt="Okta アプリの Assignments のアクセス制御オプション" width="1599" height="493" data-path="assets/media/images/iru-okta-passport-app-assignments.png" />
        </Frame>
      </Step>
    </Steps>

    ### 設定の詳細を収集する

    <Steps>
      <Step title="安全なドキュメントを準備する">
        この OIDC アプリの値を保存するために使用できる安全なテキストドキュメントを開きます。これらの詳細は、Passport Library Item を設定するときに必要になります。
      </Step>

      <Step title="Client ID をコピーする">
        作成した OIDC アプリケーションの General タブで、**Client ID** フィールドの右側にあるクリップボードのような**コピーアイコン**を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-client-id.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=6dac7bfe231729ee57f77a9021abccc4" alt="General タブの Okta Passport の Client ID" width="2562" height="1396" data-path="assets/media/images/iru-okta-passport-client-id.png" />
        </Frame>
      </Step>

      <Step title="Client ID を保存する">
        値を安全なテキストドキュメントに貼り付けます。
      </Step>

      <Step title="IDプロバイダーのURL の形式をコピーする">
        次のテキストから **IDプロバイダーのURL** の形式をコピーします。

        ```
        https://yourOktaDomain/.well-known/openid-configuration
        ```
      </Step>

      <Step title="IDプロバイダーのURL を保存する">
        テキストを安全なテキストドキュメントに貼り付けます。
      </Step>

      <Step title="ドメインのプレースホルダーを置き換える">
        安全なテキストドキュメントで、yourOktaDomain を Okta ドメインに置き換えます。
      </Step>
    </Steps>

    <Tip>
      カスタムのサインオンポリシールールは必要ありませんが、追加する場合は MFA が無効になっていることを確認してください。
    </Tip>

    <Note>
      MFA を設定する必要がない場合は、[**Iru Endpoint** タブ](#iru-endpoint)を開きます。MFA を設定する必要がある場合は、[次のセクション](#enable-multifactor-authentication)に従ってください。
    </Note>

    ### 多要素認証を有効にする

    <Warning>
      Okta の MFA ポリシーは、Okta の Passport アプリケーションではなく、ユーザーまたはグループに適用する必要があります。
    </Warning>

    Passport で MFA を使用する場合は、Okta と Passport Library Item を更新します。両者の違いについて詳しくは、Okta の記事 [Okta Classic と OIE の違い](https://support.okta.com/help/s/article/Setting-Up-Okta-Verify-Differences-Between-Classic-and-Okta-Identity-Engine-OIE?language=en_US)を参照してください。ご使用の Okta エンジンのセクションを展開するか、[Okta Identity Engine](#okta-identity-engine) または [Classic Engine](#classic-engine) のリンクを使用してください。

    <AccordionGroup>
      <Accordion title="Okta Identity Engine、OIE">
        <span id="okta-identity-engine" />

        **Okta Authenticators**

        <Steps>
          <Step title="セキュリティセクションにアクセスする">
            左側のナビゲーションから **セキュリティ** セクションを展開します。
          </Step>

          <Step title="Authenticators を開く">
            **Authenticators** を選択します。
          </Step>

          <Step title="MFA の方法を確認する">
            Okta Verify など、少なくとも 1 つの多要素認証の方法が一覧に表示されていることを確認します。
          </Step>

          <Step title="必要に応じて認証システムを追加する">
            多要素認証の方法が一覧に表示されていない場合は、**Add authenticator** ボタンを選択します。

            <Frame>
              <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-security-authenticators.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=9ee9053cb76190e8c342d8febf17d2ad" alt="Add authenticator が表示された Okta の Security の Authenticators" width="1410" height="1020" data-path="assets/media/images/iru-okta-passport-security-authenticators.png" />
            </Frame>
          </Step>

          <Step title="認証システムを選択する">
            必要な各認証システムの下にある **追加** ボタンを選択します。

            <Frame>
              <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-add-authenticator.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=35778eeed2961ec82dfb15da720afbdb" alt="Okta の Add Authenticator 一覧" width="845" height="882" data-path="assets/media/images/iru-okta-passport-add-authenticator.png" />
            </Frame>
          </Step>

          <Step title="設定を完了する">
            認証システムの追加の手順を完了します。
          </Step>

          <Step title="追加を確定する">
            **追加** を選択します。
          </Step>
        </Steps>

        **Okta Global Session Policy**

        <Steps>
          <Step title="セキュリティセクションにアクセスする">
            左側のナビゲーションから **セキュリティ** セクションを展開します。
          </Step>

          <Step title="Global Session Policy を開く">
            **Global Session Policy** を選択します。
          </Step>

          <Step title="ポリシーを作成または編集する">
            **Add policy** を選択して新しいポリシーを作成するか、既存の **Default Policy** を編集する場合は次の手順に進みます。
          </Step>

          <Step title="既存の Default Policy を編集する">
            既存の **Default Policy** を編集するには、Default Rule の **アクション** 列にある鉛筆アイコンを選択します。

            <Frame>
              <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-global-session-policy.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=e7d4baa85d514a1ff08feb67c114c291" alt="Okta の Global Session Policy の Default Rule" width="1410" height="1041" data-path="assets/media/images/iru-okta-passport-global-session-policy.png" />
            </Frame>
          </Step>

          <Step title="MFA の要件を設定する">
            多要素認証を **Required** に設定します。
          </Step>

          <Step title="MFA のプロンプトの頻度を設定する">
            **Users will be prompted for MFA** を **At every sign in** に設定します。

            <Frame>
              <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-edit-rule-mfa-required.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=32146351931f96b7243aa9c2c42831ce" alt="MFA が Required で At every sign in に設定された Okta の Edit Rule" width="856" height="1013" data-path="assets/media/images/iru-okta-passport-edit-rule-mfa-required.png" />
            </Frame>
          </Step>

          <Step title="ポリシーを保存する">
            下にスクロールして、**Update rule** または **Create rule** を選択します。
          </Step>
        </Steps>

        **Authentication Policies**

        <Steps>
          <Step title="セキュリティセクションにアクセスする">
            左側のナビゲーションから **セキュリティ** セクションを展開します。
          </Step>

          <Step title="Authentication Policies を開く">
            **Authentication Policies** を選択します。
          </Step>

          <Step title="アプリケーションにアクセスする">
            **アプリケーション** を選択します。
          </Step>

          <Step title="Passport のポリシーを切り替える">
            Iru Passport アプリケーションの横にある **Switch policy** を選択します。
          </Step>

          <Step title="Password only ポリシーを選択する">
            **Use this policy for Iru Passport** ポリシーで、**Password only** を選択します。
          </Step>

          <Step title="ポリシーを保存する">
            **保存** を選択します。

            <Frame>
              <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-auth-policy-password-only.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=a1f7d4ef3bbd64cec10ecb872b23eaa3" alt="Okta の認証ポリシーを Password only に変更" width="782" height="319" data-path="assets/media/images/iru-okta-passport-auth-policy-password-only.png" />
            </Frame>
          </Step>
        </Steps>
      </Accordion>

      <Accordion title="Classic Engine">
        <span id="classic-engine" />

        **Okta MFA Settings**

        <Steps>
          <Step title="セキュリティセクションにアクセスする">
            左側のナビゲーションから **セキュリティ** セクションを展開します。
          </Step>

          <Step title="認証を開く">
            **認証** を選択します。
          </Step>

          <Step title="Sign On にアクセスする">
            **Sign On** を選択します。
          </Step>

          <Step title="新しいポリシーを追加する">
            **Add New Okta Sign-on Policy** を選択します。

            <Frame>
              <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-sign-on-policies.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=50b94e544b16b2d8099d59a004587a65" alt="Okta の Authentication の Sign On の Add New Okta Sign-on Policy" width="1294" height="839" data-path="assets/media/images/iru-okta-passport-sign-on-policies.png" />
            </Frame>
          </Step>

          <Step title="ポリシーの詳細を設定する">
            MFA Required のような **Policy name** を入力します。
          </Step>

          <Step title="ポリシーの説明を追加する">
            **Policy Description** を入力します。
          </Step>

          <Step title="グループを選択する">
            この MFA 要件を割り当てるグループを選択します。
          </Step>

          <Step title="ポリシーを作成する">
            **Create policy and add rule** を選択します。

            <Frame>
              <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-add-policy-mfa-required.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=1fab1d5a478edea2918830fed18c9042" alt="Okta の Add Policy MFA Required" width="579" height="406" data-path="assets/media/images/iru-okta-passport-add-policy-mfa-required.png" />
            </Frame>
          </Step>

          <Step title="ルール名を入力する">
            **Rule name** を入力します。
          </Step>

          <Step title="MFA の要件を設定する">
            多要素認証で **Required** を選択します。
          </Step>

          <Step title="MFA の頻度を設定する">
            **Users will be prompted for MFA** 設定で **At every sign in** を選択します。

            <Frame>
              <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-add-rule-require-mfa.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=af1c4504bdf2b67074413dc3ce850122" alt="Okta の Add Rule の Require multifactor authentication" width="869" height="943" data-path="assets/media/images/iru-okta-passport-add-rule-require-mfa.png" />
            </Frame>
          </Step>

          <Step title="ルールを作成する">
            ウインドウの下部にある **Create rule** を選択します。

            <Frame>
              <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-create-rule.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=9b15a22279e6c1f5251f92ad48554dbb" alt="グローバルセッション管理用の Okta の Create rule" width="866" height="510" data-path="assets/media/images/iru-okta-passport-create-rule.png" />
            </Frame>
          </Step>
        </Steps>
      </Accordion>
    </AccordionGroup>

    <Note>
      [**Iru Endpoint** タブ](#iru-endpoint)に切り替えて、そこで Passport Library Item の手順を進めます。そのタブの最初から始めてください。完了したら、このタブに戻り、以下の **Okta でグループクレームフィルターを設定する**に進みます。
    </Note>

    ### Okta でグループクレームフィルターを設定する

    Passport の OIDC アプリケーションで **Groups claim filter** を設定し、Passport が想定するグループクレームを Okta が送信するようにします。この記事では、例として *Mac-* で始まる名前を使用します。

    <Steps>
      <Step title="アプリケーションにアクセスする">
        Okta 管理コンソールの左側のメニューペインで、必要に応じて Applications セクションを展開し、**アプリケーション** を選択します。
      </Step>

      <Step title="Passport アプリケーションを選択する">
        以前に作成した **Iru Passport** アプリケーションを選択します。
      </Step>

      <Step title="Sign On タブを開く">
        **Sign On** タブを選択します。
      </Step>

      <Step title="ID トークンを編集する">
        **OpenID Connect ID Token** セクションで、Edit を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-oidc-id-token.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=f7c9d1131258cdd12cb6dfa25b4c5116" alt="Okta の OpenID Connect ID Token の設定" width="1472" height="808" data-path="assets/media/images/iru-okta-passport-oidc-id-token.png" />
        </Frame>
      </Step>

      <Step title="Groups claim filter を設定する">
        **Groups claim filter** セクションでは、デフォルト値の **groups** のままにします。
      </Step>

      <Step title="フィルター条件を設定する">
        中央のフィールドはデフォルトの **Starts with** のままにします。
      </Step>

      <Step title="グループのプレフィックスを入力する">
        使用している、または使用予定の Okta グループが **Mac** で始まる場合は、右端のフィールドに **Mac** と入力します。
      </Step>

      <Step title="設定を保存する">
        **保存** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-passport-groups-claim-filter.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=afb700d01533a770e2231a70598ac9f2" alt="Starts with Mac に設定された Okta の Groups claim filter" width="1458" height="1008" data-path="assets/media/images/iru-okta-passport-groups-claim-filter.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Iru Endpoint" id="iru-endpoint">
    まだ行っていない場合は、[Passport Library Item の設定](/ja/endpoint/library/passport/configure-the-passport-library-item)を使用して Passport Library Item と基本設定を追加します。以下の手順は、Okta の Passport に固有の **Iru Endpoint** の設定です。

    ### 認証モード

    Passport Library Item の **認証モード** を、ユーザーが Okta でサインインする方法に合わせて設定します。MFA が適用される場合は **Webログイン** を、適用されない場合は **Macログイン** を使用します。

    **Okta** タブで収集した値を使用して、まず以下の手順を完了します。その後、**Webログイン** または **Macログイン** に従います。

    <Steps>
      <Step title="Okta の ID プロバイダを選択する">
        Passport Library Item で、**IDプロバイダー** を **Okta** に設定します。
      </Step>

      <Step title="IDプロバイダーのURL を入力する">
        **IDプロバイダーのURL** フィールドに、**Okta** タブで取得した Okta の OIDC well-known 設定 URL を入力します。次のパターンに従います。

        ```bash theme={null}
        https://{yourOktaDomain}/.well-known/openid-configuration
        ```
      </Step>

      <Step title="Client ID (パスワード同期) を入力する">
        **Client ID (Password Sync)** フィールドに、**Okta** タブの OIDC アプリの **Application ID**（クライアント ID）を入力します。
      </Step>
    </Steps>

    #### Webログイン

    Passport で多要素認証を使用する場合、ユーザーがサインイン時に MFA を完了できるよう、認証モードとして **Webログイン** を使用する必要があります。

    <Steps>
      <Step title="Webログイン を選択する">
        **認証モード** で、**Webログイン** を選択します。
      </Step>

      <Step title="リダイレクト URI を入力する">
        **Redirect URI** フィールドに、次のように入力します。

        ```
        https://localhost.redirect
        ```

        <Frame>
          <img src="https://mintcdn.com/iru/auny609w8TU-4qYr/assets/media/images/iru-passport-okta-web-login-redirect-uri.png?fit=max&auto=format&n=auny609w8TU-4qYr&q=85&s=a81382e7020de19e41c16f3807eb22cc" alt="Okta 用の Passport Library Item の Webログイン のリダイレクト URI" width="2296" height="992" data-path="assets/media/images/iru-passport-okta-web-login-redirect-uri.png" />
        </Frame>
      </Step>

      <Step title="設定を保存する">
        **保存** を選択します。
      </Step>
    </Steps>

    #### Macログイン

    Passport で MFA を使用しない場合は、認証モードとして **Macログイン** を使用します。ユーザーは、Webログイン の MFA フローを使用せずに、Mac のログインウインドウで Okta のパスワードを使用してサインインします。

    <Steps>
      <Step title="Macログイン を選択する">
        **認証モード** で、**Macログイン** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/auny609w8TU-4qYr/assets/media/images/iru-passport-okta-mac-login.png?fit=max&auto=format&n=auny609w8TU-4qYr&q=85&s=f4aafe98a0e07348d24d9d990f4ec9ef" alt="Okta 用に 認証モード が Macログイン に設定された Passport Library Item" width="2272" height="768" data-path="assets/media/images/iru-passport-okta-mac-login.png" />
        </Frame>
      </Step>

      <Step title="設定を保存する">
        **保存** を選択します。
      </Step>
    </Steps>

    ### ユーザープロビジョニング

    Okta グループのメンバーシップに基づいて各ユーザーの Mac アカウントの種類を Passport で設定する場合は、Passport Library Item の [**Iru Endpoint** タブ](#iru-endpoint)で以下の **ユーザープロビジョニング** の手順を使用します。Okta で使用するグループは *Mac-* で始まる必要はありませんが、この記事の例のグループではそのプレフィックスを使用しています。

    <Steps>
      <Step title="ユーザーアカウントの種類を設定する">
        Passport Library Item の ユーザープロビジョニング セクションで ユーザーアカウントの種類 メニューを選択し、**IDプロバイダーグループごとに指定** を選択します。
      </Step>

      <Step title="フォールバックのアカウントの種類を選択する">
        **ユーザーアカウントの種類** を **IDプロバイダーグループごとに指定** に設定した状態で、その下のアカウントの種類のドロップダウンを開き、Administrator または Standard ユーザーを選択します。ユーザーの IdP グループメンバーシップから Administrator と Standard の両方のアカウントの種類が返される場合、そのユーザーは Administrator に指定されます。
      </Step>

      <Step title="グループ名を入力する">
        **IDプロバイダーグループ** フィールドに、Okta のグループ名を入力します。この記事では、例として *Mac-* で始まるグループを使用しています。
      </Step>

      <Step title="アカウントの種類を設定する">
        各 **IDプロバイダーグループ** の行で、**Account type** を適切に設定します。

        <Frame>
          <img src="https://mintcdn.com/iru/auny609w8TU-4qYr/assets/media/images/iru-okta-passport-user-provisioning.png?fit=max&auto=format&n=auny609w8TU-4qYr&q=85&s=8f214156986ed1b377c1875e15ed5b93" alt="Okta 用の Passport Library Item の ユーザープロビジョニング" width="2716" height="1920" data-path="assets/media/images/iru-okta-passport-user-provisioning.png" />
        </Frame>
      </Step>
    </Steps>

    <Note>
      Passport Library Item で **ユーザープロビジョニング** と関連する保存が完了したら、**Okta** タブに戻り、まだ完了していない場合は [Okta でグループクレームフィルターを設定する](#configure-the-group-claim-filter-in-okta)を完了します。全体の流れが必要な場合は、そのタブの最初から始めてください。
    </Note>
  </Tab>
</Tabs>

### Passport と Okta に関する問題のトラブルシューティング

Passport と Okta で問題が発生した場合は、[Okta での Passport のトラブルシューティング](/ja/endpoint/library/passport/okta/passport-troubleshooting-with-okta)の記事で詳細を確認してください。
