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

# OktaでSSOを設定する

<Note>
  日本語版はAIによる翻訳です。正確な情報については[英語版](/guides/comprehensive/sso/okta)をご参照ください。
</Note>

このガイドでは、OktaをAuxiaのSAML SSOプロバイダーとして設定する手順を説明する。

## 始める前に

以下を準備する。

* [ ] Okta組織の管理者アクセス権
* [ ] Auxia担当者から提供される **ACS URL**
* [ ] Auxia担当者から提供される **SP Entity ID**

ACS URLとSP Entity IDをまだ受け取っていない場合は、先にAuxia担当者に連絡して取得する。

***

## ステップ1：OktaにSAMLアプリケーションを作成する

1. Okta管理ダッシュボードにログインする。
2. **Applications** → **Applications** に移動する。
3. **Create App Integration** をクリックする。
4. サインオン方式として **SAML 2.0** を選択する。
5. **Next** をクリックする。
6. アプリケーション名を入力する（例：`Auxia`）。
7. **Next** をクリックする。

***

## ステップ2：SAML設定を行う

**Configure SAML** のステップで、以下のフィールドに値を入力する。

| フィールド | 値 |
| - | - |
| **Single sign-on URL** | Auxiaから提供された **ACS URL** を貼り付ける |
| **Audience URI (SP Entity ID)** | Auxiaから提供された **SP Entity ID** を貼り付ける |

Auxia担当者から別途指示がない限り、他のフィールドはデフォルト値のままにする。

***

## ステップ3：グループ属性ステートメントを設定する（任意）

OktaグループをAuxiaのロール割り当てに使用する場合は、グループ属性を追加する。

1. **Group Attribute Statements** までスクロールする。

2. 以下の値で新しいステートメントを追加する。

   | フィールド | 値 |
   | - | - |
   | **Name** | `groups` |
   | **Filter** | Matches regex: `.*`（すべてのグループを含める） |

3. **Next** をクリックする。

> **注意:** グループベースのロール割り当てはAuxia側での追加設定が必要である。この機能を使用する場合はAuxia担当者に連絡する。

***

## ステップ4：フィードバックフォームに回答する

1. **I'm an Okta customer adding an internal app** を選択する。
2. フィードバックフォームに回答する。
3. **Finish** をクリックする。

***

## ステップ5：ユーザーとグループを割り当てる

1. アプリケーションの **Assignments** タブをクリックする。
2. **Assign** をクリックし、**Assign to People** または **Assign to Groups** を選択する。
3. Auxiaにアクセスさせるユーザーまたはグループを検索して選択する。
4. **Assign** をクリックし、**Done** をクリックする。

> **注意:** ここで割り当てたユーザーのみがSSOを使用してAuxiaに認証できる。

***

## ステップ6：IdPメタデータURLをコピーする

1. Oktaアプリケーションの **Sign On** タブをクリックする。
2. **SAML Signing Certificates** で、有効な証明書の **Actions** ドロップダウンをクリックする。
3. **View IdP Metadata** を選択する。新しいブラウザタブが開き、メタデータXMLが表示される。
4. ブラウザのアドレスバーからURLをコピーする。

***

## ステップ7：メタデータURLをAuxiaに共有する

コピーした **IdPメタデータURL** をAuxia担当者に送信する。担当者がAuxia側でSSO接続の設定を完了する。

接続が有効化されると、組織のユーザーはOktaの認証情報を使用してAuxia Consoleにログインできる。

***

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

### セットアップ後にユーザーがログインできない

* ユーザーがOktaアプリケーションに割り当てられているか確認する（ステップ5）。
* ACS URLとSP Entity IDが正しく入力されているか確認する（ステップ2）。
* メタデータURLが有効な証明書のものであることを確認する。

### メタデータURLが機能しない

* **View IdP Metadata** をクリックした後、ブラウザのアドレスバーからURLをコピーしたか確認する（ダウンロードリンクではないことを確認する）。
* 証明書が変更された場合は、新しいメタデータURLをコピーしてAuxia担当者に共有する。

### サポートが必要な場合

Auxia担当者または [support@auxia.io](mailto:support@auxia.io) に問い合わせる。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.