> ## 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.

# Passport の高度なトラブルシューティング

> Iru Endpoint における Passport の高度な問題をトラブルシューティングします。トークン更新の失敗、IdP 同期の問題、キーチェーンのエラー、ログインループのシナリオを診断します。

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

### ログイン、診断、ネットワーク

<CardGroup cols={2}>
  <Card title="完全なメールアドレスでサインインする" icon="user">
    Passport のログインウインドウでは、セッションがローカル認証ではなく IdP を使用するよう、ユーザー名フィールドに必ずユーザーの完全なメールアドレスを入力してください。ログインウインドウと表示設定が Passport とどのように相互作用するかについては、[Passport の互換性](/ja/endpoint/library/passport/passport-compatibility-with-macos-and-iru-endpoint-features#login-window)を参照してください。
  </Card>

  <Card title="Passport Diagnostics を使用する" icon="display">
    ユーザーがサインインできない場合は、Mac で **Command-Shift-K-L** を押して Iru Endpoint Passport Diagnostics を開きます。このパネルには、IdP から返されたエラーメッセージなど、有用な詳細情報が表示されます。
  </Card>

  <Card title="ネットワーク接続を確認する" icon="wifi">
    Passport は、資格情報を検証するために IdP に接続できる必要があります。Passport のログインウインドウをカスタマイズする際は、必要に応じてユーザーが Wi-Fi に接続できるよう、ネットワークマネージャーを有効にしてください。このコントロールは macOS の AirPort セキュリティ設定に従います。
  </Card>

  <Card title="Wi-Fi の制限と切り分けテスト" icon="triangle-exclamation">
    Passport はログインウインドウの右上に Wi-Fi アイコンを表示し、ユーザーはこれを選択してパスワードで保護されたネットワークに接続できます。Passport は、キャプティブポータル、クリックスルー方式の同意ページ、またはこのフローで別途ユーザー名とパスワードを必要とするエンタープライズ 802.1X ネットワークをサポートしていません。ネットワークの問題を切り分けるには、Passport のログインウインドウでテストする際にモバイルホットスポットまたは有線イーサネットを試してください。
  </Card>
</CardGroup>

### IdP で姓（familyName）が設定されていることを確認する

Passport では、IdP のユーザー属性に **familyName** の値が必要です。テストに使用するサービスアカウントを含め、Passport でサインインするすべてのアカウントで **Last name** または同等の姓フィールドを設定してください。

### Passport がサポートする IdP

現在 Iru Endpoint Passport がサポートしている IdP は、[Google Workspace](/ja/endpoint/library/passport/google-workspace/passport-configuration-with-google-workspace)、[Microsoft Entra ID](/ja/endpoint/library/passport/microsoft-entra-id/passport-troubleshooting-with-microsoft-entra-id-formerly-azure-ad)、[Okta](/ja/endpoint/library/passport/okta/passport-configuration-with-okta)、[OneLogin](/ja/endpoint/library/passport/onelogin/passport-configuration-with-onelogin) です。

### その他の IdP を使用する場合の Passport の要件

[Passport の設定](/ja/endpoint/library/passport/configure-the-passport-library-item)が機能するには、OIDC と ROPG（Resource Owner Password Grant）のワークフローが必要です。IdP がこれらの機能をサポートしているかどうかを IdP に確認してください。

Iru では Macログイン または Webログイン を選択できますが、Webログイン の設定には追加の要素が関係する場合があるため、まず Macログイン を使用して Passport を設定してください。Google Workspace、Microsoft Entra ID、Okta、OneLogin を使用したサポート対象の設定を参考資料として参照できます。

* [Google Workspace での Passport の設定](/ja/endpoint/library/passport/google-workspace/passport-configuration-with-google-workspace)
* [Microsoft Entra ID（旧 Azure AD）での Passport の設定](/ja/endpoint/library/passport/microsoft-entra-id/configure-passport-with-microsoft-entra-id-mac-login)
* [Okta での Passport の設定](/ja/endpoint/library/passport/okta/passport-configuration-with-okta)
* [OneLogin での Passport の設定](/ja/endpoint/library/passport/onelogin/passport-configuration-with-onelogin)

上記のいずれの ID プロバイダも使用していない場合でも、**その他** オプションを使用して Passport を設定できる場合があります。

### その他の IdP を設定する

#### 認証の設定

* Google Workspace、Microsoft Entra ID、Okta、OneLogin 以外の IdP を設定する場合は、**IDプロバイダー** ドロップダウンから **その他** オプションを選択します。

#### 認証モード

* 多要素認証（MFA）を使用**しない**場合は、Macログイン を選択する必要があります。

* 多要素認証（MFA）を使用**する**場合は、Webログイン を選択する必要があります。

#### Macログイン

<Steps>
  <Step title="Identity Provider URL を入力する">
    **IDプロバイダーのURL** を入力します。
  </Step>

  <Step title="Client ID を入力する">
    IdP で作成した Passport アプリの **Client ID**（App ID と呼ばれる場合もあります）を入力します
  </Step>
</Steps>

#### Webログイン

<Steps>
  <Step title="Identity Provider URL を入力する">
    **Identity Provider URL** を入力します
  </Step>

  <Step title="Client ID を入力する">
    IdP で作成した Passport アプリの **Client ID**（App ID と呼ばれる場合もあります）を入力します
  </Step>

  <Step title="PKCE と POST 認証のサポートを設定する">
    Webログイン を使用する場合、アプリは PKCE（Proof Key for Code Exchange）認証と POST 認証の両方をサポートしている必要があります。IdP によっては、2 つの異なるアプリの設定が必要な場合があります。
  </Step>

  <Step title="Redirect URI を設定する">
    ほとんどの場合、**Redirect URI** には IdP のデフォルトの Redirect URI を指定します。
  </Step>
</Steps>

### トラブルシューティング

Passport の IdP に **その他** オプションを選択している場合、Passport の問題をトラブルシューティングする際に考慮すべき要素が数多くあります。このセクションでは、エラーを取得して理解し、設定を調整する方法について説明します。

<AccordionGroup>
  <Accordion title="POST token 401: 無効なユーザー資格情報">
    **表示される内容:**

    `"error":"Unauthorized","error_description":"Authentication Failed: Invalid user credentials"`

    **対処方法:**

    * IdP でユーザー名とパスワードを確認します。
    * OIDC の well-known `openid-configuration` URL への GET リクエストが **200** を返す場合、通常、Passport Library Item の **IDプロバイダーのURL** と **Client ID** は IdP に正しく到達しています。IdP によっては、クライアント識別子が **Application ID** と表示される場合があります。
  </Accordion>

  <Accordion title="POST token 403: ユーザーが Passport アプリにアクセスできない">
    **表示される内容:**

    `"error":"access_denied","error_description":"End-user does not have access to this application"`

    **対処方法:**

    * IdP で、ユーザーまたはグループが Passport OIDC アプリケーションにアクセスでき、サインオンまたはアクセスのルールで許可されていることを確認します。
    * OIDC の well-known `openid-configuration` URL への GET リクエストが **200** を返す場合、通常、Passport Library Item の **IDプロバイダーのURL** と **Client ID** は IdP に正しく到達しています。IdP によっては、クライアント識別子が **Application ID** と表示される場合があります。
  </Accordion>

  <Accordion title="Ticket Decode failed">
    **表示される内容:**

    Ticket decode failed. Failed to login with possible error: Unknown

    **対処方法:**

    * Passport Library Item からオプションの **Client secret** を削除し、デバイスのチェックインを待ってから、ローカルユーザーからサインアウトし、Passport で再度サインインします。
    * エラーが解消しない場合は、Passport のログインウインドウでモバイルホットスポットを使用して、ネットワークの問題を除外します。
  </Accordion>

  <Accordion title="No key was found matching familyName">
    **表示される内容:**

    An error occurred fetching user info: No key was found matching "familyName"

    **対処方法:**

    * IdP でユーザーの **Last name** または同等の姓フィールドを設定します。Passport ではこの属性が必要です。
  </Accordion>
</AccordionGroup>

Passport で引き続き問題が発生する場合は、[サポートにお問い合わせください](/ja/iru/iru-support/support-customer-portal)。

#### エラーコードの検索

多くの IdP は独自のエラーコードを生成します。IdP から受け取った特定のエラーについて詳しく調べられる検索ページがあるかどうか、IdP に確認してください。その一例として、Microsoft Entra ID のエラーを検索するための Microsoft の[エラーコードフォーム](https://login.microsoftonline.com/error)があります。

### 関連記事

<CardGroup cols={2}>
  <Card title="Passport と macOS および Iru Endpoint 機能との互換性" icon="apple" href="/ja/endpoint/library/passport/passport-compatibility-with-macos-and-iru-endpoint-features">
    Passport と macOS および Iru 機能との互換性
  </Card>

  <Card title="Passport によるパスワードの管理" icon="key" href="/ja/endpoint/library/passport/managing-passwords-with-passport">
    Passport でパスワードを管理する方法。
  </Card>
</CardGroup>