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

# SSO と SCIM プロビジョニングを設定する

> IdP を AhaSlides に接続してシングルサインオンを有効にし、メールドメインで SSO を必須にして、SCIM 2.0 でチームメンバーを自動でプロビジョニングします。

シングルサインオン（SSO）を使うと、チームのメンバーは AhaSlides のパスワードではなく、組織の IdP（ID プロバイダー）を通じて AhaSlides にログインできます。SCIM プロビジョニングは、同じ IdP からメンバーのアカウントを作成・無効化します。AhaSlides にアクセスできるユーザーを 1 か所で管理したい IT チームは、この 2 つを併用してください。

## SSO と SCIM を始める前に

SSO と SCIM は、すべてのプランで利用できるわけではありません。チームに追加するには、[Enterprise フォーム](https://ahaslides.com/enterprise/)または [hi@ahaslides.com](mailto:hi@ahaslides.com) からお問い合わせください。

チームの設定に SSO や SCIM の画面はありません。お客様側で IdP を設定していただき、AhaSlides 側の設定は弊社チームが代わりに完了します。

| ステップ | お客様 | AhaSlides |
| - | - | - |
| IdP を接続する | IdP で AhaSlides のアプリを作成し、その詳細を弊社に送る | プロバイダー名をお送りし、チームの SSO をオンにする |
| メールドメインを紐づける | チームがサインインに使うドメインを弊社に伝える | ドメインをチームに紐づける |
| SSO のみのログインを必須にする | オンにするよう弊社に依頼する | 紐づけたドメインに対してオンまたはオフにする |
| SCIM プロビジョニング | IdP に SCIM URL とトークンを入力する | SCIM トークンを発行する |

IdP の管理者権限と、メンバーが参加する AhaSlides の[チーム](/jp/teams-and-enterprise/managing-your-team-members)が必要です。

## IdP を接続する

AhaSlides は、Okta などの SAML 2.0 に対応した IdP と、Microsoft Entra ID に対応しています。

<Steps>
  <Step title="SSO をオンにするよう依頼する">
    チーム名と、お使いのメールドメインを添えて弊社にご連絡ください。弊社から、**プロバイダー名**（SSO のアドレスに表示される、組織を表す短い識別子）をお送りします。
  </Step>

  <Step title="IdP で AhaSlides のアプリを作成する">
    SAML 2.0 のプロバイダーの場合は、次の値で SAML アプリを作成します。

    | フィールド | 値 |
    | - | - |
    | シングルサインオン URL（ACS URL） | `https://presenter.ahaslides.com/p/saml/your-provider-name/login/callback` |
    | Audience URI（SP エンティティ ID） | プロバイダー名と一緒に弊社がお送りする値 |
    | Name ID | ユーザーのメールアドレス |

    サービスプロバイダーのメタデータは、`https://presenter.ahaslides.com/p/saml/your-provider-name/metadata` からダウンロードすることもできます。

    Microsoft Entra ID の場合は、代わりにアプリケーションを登録します。追加するリダイレクト URI は弊社がお送りします。
  </Step>

  <Step title="IdP の詳細を弊社に送る">
    SAML の場合は、IdP のサインオン URL、発行者、X.509 署名証明書、またはそれらを含むメタデータファイルをお送りください。名と姓を入力したい場合は、それらを含む属性をお知らせください。

    Microsoft Entra ID の場合は、テナント ID、クライアント ID、クライアントシークレットをお送りください。
  </Step>

  <Step title="ユーザーを割り当ててテストする">
    AhaSlides を使うユーザーにアプリを割り当てます。接続が有効になったことを弊社が確認したら、「SSO でサインインする」の手順に従ってテストしてください。
  </Step>
</Steps>

## メールドメインをチームに紐づける

SSO は、チームに紐づけられたドメインのメールアドレスでのみ機能し、そのドメインの紐づけは弊社が行います。メンバーがサインインに使うすべてのドメインをお知らせください。

* 1 つのドメインを紐づけられるのは、1 つのチームだけです。
* 紐づけられていないドメインのメールアドレスを使っている人は、お客様の SSO ではサインインできません。

## SSO でサインインする

<Steps>
  <Step title="SSO ページを開く">
    [AhaSlides のログインページ](https://presenter.ahaslides.com/pages/login)で、**SSOでログインする** (Log in with SSO) をクリックします。
  </Step>

  <Step title="勤務先のメールアドレスを入力する">
    メールアドレスを入力して **ログイン** (Log in) をクリックします。AhaSlides から、組織のサインインページに移動します。
  </Step>

  <Step title="組織のアカウントでサインインする">
    そこでサインインすると、AhaSlides に移動します。
  </Step>
</Steps>

SSO で初めてサインインしたとき、アカウントがなければ AhaSlides が作成し、**メンバー** (Member) のロールでチームに追加します。AhaSlides のパスワードを設定する必要はありません。

## ドメインで SSO を必須にする

デフォルトでは、SSO を設定してもサインイン方法が 1 つ増えるだけで、他の方法は無効になりません。すでに AhaSlides のパスワードをお持ちの方は、引き続きそのパスワードを使えます。組織で SSO を唯一のサインイン方法にしたい場合は、紐づけたドメインで SSO のみのログインをオンにするよう弊社にご依頼ください。その前に、SSO の接続が正常に動作している必要があります。

オンにすると、紐づけられたドメインのメールアドレスを使う人には、次のように表示されます。

| 場所 | 表示される内容 |
| - | - |
| ログイン、サインアップ、パスワード再設定のページ | メールアドレスを入力すると、**組織でシングルサインオン（SSO）が必須です** (Your organisation requires single sign-on) というタイトルのウィンドウが表示されます。**SSOで続ける** (Continue with SSO) で SSO ページに移動し、**別のメールアドレスを使用** (Use a different email) で入力欄が消去されます。 |
| SSO ページ | 「Your organisation requires single sign-on. Please continue below to sign in.」というメッセージと、入力済みのメールアドレス |
| アカウント設定 | **パスワード** (Password) セクションが表示されず、メールアドレスを編集できません |

これは、まだチームに参加していない人も含め、紐づけられたドメインのすべてのアドレスに適用されます。

## SCIM ユーザープロビジョニングを設定する

SCIM を使うと、IdP が AhaSlides のアカウントを作成、更新、無効化してくれます。AhaSlides は、ユーザーに対する SCIM 2.0 に対応しています。

<Steps>
  <Step title="SCIM トークンを依頼する">
    トークンは弊社が発行してお送りします。安全な場所に保管してください。弊社にはそのハッシュしか保管されないため、再表示はできません。紛失した場合や漏えいの可能性がある場合は、新しいトークンを弊社にご依頼ください。
  </Step>

  <Step title="IdP に接続情報を入力する">
    | 設定 | 値 |
    | - | - |
    | SCIM ベース URL | `https://presenter.ahaslides.com/api/scim/v2` |
    | 認証 | Bearer トークン。`Authorization: Bearer your-token` として送信 |
    | 一意の識別子 | `userName` |
  </Step>

  <Step title="ユーザー属性をマッピングする">
    「対応している SCIM 属性」に記載された属性をマッピングし、ユーザーの作成、更新、無効化をオンにします。パスワードの同期はオフのままにしてください。
  </Step>

  <Step title="ユーザーを割り当てる">
    AhaSlides のアプリに、ユーザーまたはグループを割り当てます。すると IdP がアカウントを作成します。
  </Step>
</Steps>

### 対応している SCIM 属性

| SCIM 属性 | 用途 |
| - | - |
| `userName` | メンバーのメールアドレス。ユーザーを識別し、小文字で保存されます。 |
| `name.givenName`, `name.familyName` | 名と姓 |
| `displayName` | `name` が送信されない場合にのみ、名前として使われます。最初の単語が名、残りが姓になります |
| `active` | `true` はアカウントを有効のままにし、`false` は無効化してメンバーをサインアウトさせます |
| `externalId` | レスポンスでそのまま返されます |

### 対応している SCIM 操作

| メソッド | エンドポイント | 内容 |
| - | - | - |
| `GET` | `/Users` | チームのユーザーを一覧表示します。`filter=userName eq "name@example.com"`、`startIndex`、`count`（デフォルトは 10）を指定できます。 |
| `GET` | `/Users/{id}` | ユーザーを 1 人取得します |
| `POST` | `/Users` | ユーザーを作成します |
| `PATCH` | `/Users/{id}` | `active` など、一部の属性を更新します |
| `PUT` | `/Users/{id}` | ユーザーの属性を置き換えます |

グループと `DELETE` には対応していません。ユーザーのアクセスを取り消すには `active` を `false` に設定します。多くの IdP は、ユーザーの割り当てを解除すると、この値を送信します。

SCIM で作成されたユーザーは、**メンバー** (Member) のロールでチームに参加します。そのメールアドレスがすでにチームに所属していない AhaSlides アカウントのものである場合は、新しいアカウントを作成する代わりに、そのアカウントがチームに追加されます。

### チームページで変わること

SCIM がオンの間は、メンバーの管理は IdP で行います。チームページには**招待する** (Invite) ボタンが表示されなくなり、メンバーはアカウント設定で自分のメールアドレスを編集できなくなります。

## SSO と SCIM のトラブルシューティング

### SCIM の接続テストが 401 を返す

トークンがない、入力ミスがある、またはすでに無効です。トークンが前後に何も付けずに Bearer トークンとして送信されているか確認してください。それでも失敗する場合は、新しいトークンを弊社にご依頼ください。

### プロビジョニングされたメンバーの名前が正しくない、または空になっている

`name.givenName` と `name.familyName` を送信してください。`displayName` だけが送信された場合、AhaSlides は最初のスペースで分割するため、3 つ以上の部分からなる名前は正しく分けられません。

### メンバーが SSO でサインインできない

そのメンバーが IdP で AhaSlides のアプリに割り当てられていること、そしてメールのドメインが紐づけを依頼したものであることを確認してください。新しいドメインを追加した場合は、紐づけできるよう弊社にお知らせください。

## よくある質問

<AccordionGroup>
  <Accordion title="1 つのメールドメインを 2 つのチームに紐づけられますか？">
    いいえ。各ドメインは 1 つのチームにのみ属するため、そのドメインのユーザー全員が同じチームにサインインします。
  </Accordion>

  <Accordion title="SCIM は AhaSlides のアカウントを削除しますか？">
    いいえ。SCIM はアカウントを無効化し、メンバーをサインアウトさせます。プレゼンテーションはアカウントに残ります。
  </Accordion>

  <Accordion title="SSO を使っていてパスワードを忘れました。どうすればよいですか？">
    リセットする AhaSlides のパスワードはありません。**SSOでログインする** (Log in with SSO) からサインインしてください。パスワードの再設定が SSO アカウントをどう扱うかについては、[パスワードを変更またはリセットする](/jp/account-management/change-or-reset-your-password)をご覧ください。
  </Accordion>
</AccordionGroup>

**ご質問はありますか？**

サポートチームまでお問い合わせください。ログイン済みの場合はダッシュボード右下のチャットアイコンから、ログインしていない場合は[こちらからお問い合わせ](https://ahaslides.com/contact-us/)いただくか、[hi@ahaslides.com](mailto:hi@ahaslides.com) までメールをお送りください。

他のユーザーと交流したい方は、[AhaSlides コミュニティ](https://community.ahaslides.com/)に参加して、コツを共有したり、機能をリクエストしたり、他の人がどのように聴衆を巻き込んでいるかを確認しましょう。


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