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

# SSO設定マニュアル（Microsoft Entra ID）

> Microsoft Entra ID（旧Azure AD）を使用したシングルサインオン設定ガイド

export const ContactJa = () => <>
    <Tip>
      ご不明な点がございましたら、<a href="https://forms.gle/6AUho7oj3zBr79e96">こちらのフォーム</a>よりお問い合わせください。
    </Tip>

    <h2>公式リンク</h2>

    <CardGroup cols={2}>
      <Card title="公式サイト" icon="globe" href="https://voiceping.net/">
        公式ウェブサイトはこちら
      </Card>
      <Card title="X (Twitter)" icon="x-twitter" href="https://x.com/VoicePingMedia">
        Xでフォロー
      </Card>
      <Card title="Facebook" icon="facebook" href="https://www.facebook.com/voiceping.inc">
        Facebookでいいね
      </Card>
      <Card title="LinkedIn" icon="linkedin" href="https://www.linkedin.com/company/28684130/">
        LinkedInでつながる
      </Card>
    </CardGroup>
  </>;

## シングルサインオン機能

エンタープライズプランのクライアントは、ワークスペースでシングルサインオン（SSO）を有効化し、ユーザーがMicrosoft Entra IDを使用してVoicePingにログインできるようにすることができます。

このマニュアルでは、ワークスペースでSSOを有効化する方法と、Microsoft Entra IDをIdP（アイデンティティプロバイダー）として設定する方法について説明します。

## 前提条件

<Check>VoicePingエンタープライズプランのユーザーアカウントを所持</Check>
<Check>Microsoft Azureアカウントを所持</Check>

***

## アイデンティティプロバイダーの登録

### Microsoft Entra IDの設定

<Steps>
  <Step title="エンタープライズアプリケーションに VoicePing を追加">
    AzureポータルからMicrosoft Entra IDを開き、エンタープライズアプリケーションのページを開きます。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/UDonPy9U4TF-4rTr/ja/images/sso-entra/01-azure-entra-id.png?fit=max&auto=format&n=UDonPy9U4TF-4rTr&q=85&s=b02e79d9bff931861b8146854d8716bf" alt="Azure Entra ID" width="1440" height="700" data-path="ja/images/sso-entra/01-azure-entra-id.png" />
    </Frame>

    「新しいアプリケーション」をクリックし、VoicePingを追加します。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/UDonPy9U4TF-4rTr/ja/images/sso-entra/02-enterprise-apps.png?fit=max&auto=format&n=UDonPy9U4TF-4rTr&q=85&s=d15a2f004f309344646ec9a9cec6d924" alt="エンタープライズアプリケーション" width="1486" height="794" data-path="ja/images/sso-entra/02-enterprise-apps.png" />
    </Frame>
  </Step>

  <Step title="SAML 2.0プロトコルを設定">
    IdP上のVoicePingアプリケーションについて、SSOにSAML 2.0プロトコルを使用するように設定します。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/UDonPy9U4TF-4rTr/ja/images/sso-entra/03-saml-setup.png?fit=max&auto=format&n=UDonPy9U4TF-4rTr&q=85&s=d1ee7ef387296219c8e00eb18e29544f" alt="SAML設定" width="1420" height="688" data-path="ja/images/sso-entra/03-saml-setup.png" />
    </Frame>
  </Step>

  <Step title="サービスプロバイダー（SP）情報を設定">
    VoicePingのアプリケーション内にあるワークスペースの管理ダッシュボードの「チーム管理 > SSO設定」タブで必要なフィールドを確認できます。

    <Info>
      SSOが有効化されているワークスペースのオーナーまたはマネージャーのみがアクセス可能です。
    </Info>

    | 項目        | 値                                          |
    | --------- | ------------------------------------------ |
    | ACS URL   | `https://api.voiceping.io/api/v1/user/acs` |
    | Entity ID | `voice-ping`                               |

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/UDonPy9U4TF-4rTr/ja/images/sso-entra/04-sp-config.png?fit=max&auto=format&n=UDonPy9U4TF-4rTr&q=85&s=d37efd4c234fecf241e8a29ee119a637" alt="SP設定" width="1356" height="576" data-path="ja/images/sso-entra/04-sp-config.png" />
    </Frame>
  </Step>

  <Step title="SAMLクレームにメールアドレスを含める">
    SAMLクレームにユーザーのメールアドレスを含めます。これはVoicePingプラットフォーム内で認証を行うために必要です。

    <Warning>
      IdPで定義されたメールアドレスは、VoicePingでユーザーを登録する際に使用したものと同じである必要があります。
    </Warning>

    Microsoft Entra IDではデフォルトで設定されているはずですが、設定されていない場合は追加してください。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/UDonPy9U4TF-4rTr/ja/images/sso-entra/05-claims.png?fit=max&auto=format&n=UDonPy9U4TF-4rTr&q=85&s=88af2ee3cc1463233ab55b5a9b46852e" alt="クレーム設定" width="942" height="238" data-path="ja/images/sso-entra/05-claims.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/14-configuration-step.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=0d361d1f642bbad50d2bb306a5c519de" alt="設定ステップ" width="1132" height="942" data-path="ja/images/sso-entra/14-configuration-step.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/15-attributes-mapping.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=62b9ba6c8f3b5013a59763be13ca4541" alt="属性マッピング" width="1126" height="422" data-path="ja/images/sso-entra/15-attributes-mapping.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/16-claim-configuration.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=6b55f0de6c87852a3de9e50ea708f5d6" alt="クレーム構成" width="1324" height="514" data-path="ja/images/sso-entra/16-claim-configuration.png" />
    </Frame>
  </Step>

  <Step title="ユーザーを追加">
    作成したVoicePingアプリにユーザーを追加します。

    1. Microsoft Entra IDのVoicePingアプリから「ユーザーとグループ」ページを開く
    2. 「ユーザー/グループの追加」をクリック
    3. アクセスを許可したいユーザーまたはグループを選択
    4. 「選択」と「割り当て」をクリック

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/UDonPy9U4TF-4rTr/ja/images/sso-entra/06-add-users.png?fit=max&auto=format&n=UDonPy9U4TF-4rTr&q=85&s=669c43583e467126f06e9ad0db5c4024" alt="ユーザー追加" width="1512" height="766" data-path="ja/images/sso-entra/06-add-users.png" />
    </Frame>
  </Step>

  <Step title="メールアドレスを確認">
    追加したユーザーが、Microsoft Azure上でメールアドレスを設定していることを確認してください。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/07-verify-email.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=4a4424d581be8ffc3db16bd508527283" alt="メールアドレス確認" width="1132" height="942" data-path="ja/images/sso-entra/07-verify-email.png" />
    </Frame>
  </Step>

  <Step title="メタデータファイルをダウンロード">
    IdP（Microsoft Entra ID）からメタデータファイルをダウンロードします。このファイルは後でVoicePing側で使用します。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/17-download-metadata.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=eebd136808932f4a3df27ff401669a08" alt="メタデータダウンロード" width="1078" height="534" data-path="ja/images/sso-entra/17-download-metadata.png" />
    </Frame>
  </Step>
</Steps>

***

## VoicePingの設定

<Steps>
  <Step title="SSOを有効化">
    ワークスペースの管理ダッシュボードに移動し、「チーム管理 > SSO設定」タブを開き、SSOを有効化します。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/08-enable-sso.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=455be44d72a3955447f0438c5ee0e50f" alt="SSO有効化" width="1126" height="422" data-path="ja/images/sso-entra/08-enable-sso.png" />
    </Frame>
  </Step>

  <Step title="IdPメタデータをアップロード">
    アイデンティティプロバイダータブに切り替えます。IdPとしてMicrosoft Entra IDを選択し、IdPメタデータファイルをアップロードして変更を送信します。

    <Info>
      メタデータファイルはMicrosoft Entra IDから取得できます。
    </Info>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/09-upload-metadata.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=83ccfb799777efc8bc4fcf0b73888d2c" alt="メタデータアップロード" width="1324" height="514" data-path="ja/images/sso-entra/09-upload-metadata.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/18-voiceping-sso-settings.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=e7d9b124a8056dc8b94c2be2422df5f5" alt="VoicePing SSO設定" width="1134" height="370" data-path="ja/images/sso-entra/18-voiceping-sso-settings.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/19-upload-metadata-xml.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=168dae8854d6775e31f6c99f7bacc6da" alt="メタデータXMLアップロード" width="940" height="306" data-path="ja/images/sso-entra/19-upload-metadata-xml.png" />
    </Frame>
  </Step>

  <Step title="組織IDを定義">
    組織IDを定義します。これは最低3文字、最大20文字のユニークな文字列である必要があります。

    <Warning>
      組織IDは、SSOログイン時にユーザーに要求されます。
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/10-org-id.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=6ab40a533c140ac9482eb9e3b519f474" alt="組織ID設定" width="1134" height="370" data-path="ja/images/sso-entra/10-org-id.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/20-organization-id.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=0ff5b81ad00148106d961eadf624377c" alt="組織ID入力画面" width="1468" height="360" data-path="ja/images/sso-entra/20-organization-id.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/21-sso-enabled-confirmation.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=c6f12c9adccded7db5cd5412e3979461" alt="SSO有効化確認" width="934" height="762" data-path="ja/images/sso-entra/21-sso-enabled-confirmation.png" />
    </Frame>
  </Step>

  <Step title="ユーザーを追加">
    ワークスペースにユーザーを追加します。ユーザーのメールアドレスは、Microsoft Entra ID設定で選択したユーザーのメールアドレスと一致している必要があります。

    ユーザーは招待または直接作成のいずれかの方法で追加できます。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/11-add-workspace-users.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=d5f8aaf20d9af87901c7181838ccbbf7" alt="ワークスペースユーザー追加" width="1468" height="360" data-path="ja/images/sso-entra/11-add-workspace-users.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/22-user-assignment.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=bc4bc3baab78f34b9d9a227d3939a8b1" alt="ユーザー割り当て" width="1024" height="1667" data-path="ja/images/sso-entra/22-user-assignment.png" />
    </Frame>
  </Step>
</Steps>

***

## SSOでのログイン

ワークスペースでSSOが設定されると：

* **オーナーとマネージャー**: 他の方法でもVoicePingにログイン可能
* **メンバーユーザー**: SSOで認証が必要

新しいVoicePingユーザーをSSOワークスペースに招待すると、ユーザーがSSOでサインアップした時点でVoicePingユーザーアカウントが提供されます。

### ログイン手順

1. VoicePingのログインページに移動
2. 「SSOログイン」ボタンをクリック

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/12-sso-login.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=2bc56d7ceb21cab227505830301b5ec8" alt="SSOログイン" width="1032" height="1680" data-path="ja/images/sso-entra/12-sso-login.png" />
</Frame>

3. 組織IDを入力

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/13-org-id-input.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=b83087d876e61fc2f03f303cf0c8a92a" alt="組織ID入力" width="1212" height="904" data-path="ja/images/sso-entra/13-org-id-input.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/23-test-sso-login.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=23c62802ec383efc5a51a13ee3f8745e" alt="SSOログインテスト" width="1212" height="904" data-path="ja/images/sso-entra/23-test-sso-login.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/24-org-id-login-screen.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=694925b91b1594a04ea55b51c7922e00" alt="組織IDログイン画面" width="1268" height="886" data-path="ja/images/sso-entra/24-org-id-login-screen.png" />
</Frame>

4. Microsoft Entra IDの認証ページで認証

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/25-sso-complete.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=80a9bea3e92e40bc0d7219204a464783" alt="SSO認証完了" width="2048" height="976" data-path="ja/images/sso-entra/25-sso-complete.png" />
</Frame>

***

<ContactJa />