> ## 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 Setup Manual (Microsoft Entra ID)
> Single sign-on setup guide using Microsoft Entra ID (formerly Azure AD)
export const ContactEn = () => <>
If you have any questions, please contact us via this form.
Official Links
Visit our official website
Follow us on X
Like us on Facebook
Connect on LinkedIn
;
## Single Sign-On Feature
Enterprise plan clients can enable single sign-on (SSO) in their workspace, allowing users to log in to VoicePing using Microsoft Entra ID.
This manual explains how to enable SSO in the workspace and how to configure Microsoft Entra ID as the IdP (Identity Provider).
## Prerequisites
Have a VoicePing Enterprise plan user account
Have a Microsoft Azure account
***
## Registering Identity Provider
### Microsoft Entra ID Configuration
Open Microsoft Entra ID from the Azure portal and open the Enterprise Applications page.
Click "New application" and add VoicePing.
Configure the VoicePing application on the IdP to use the SAML 2.0 protocol for SSO.
You can check the required fields in the "Team Management > SSO Settings" tab of the workspace management dashboard within the VoicePing application.
Only accessible to owners or managers of workspaces with SSO enabled.
| Item | Value |
| --------- | ------------------------------------------ |
| ACS URL | `https://api.voiceping.io/api/v1/user/acs` |
| Entity ID | `voice-ping` |
Include the user's email address in the SAML claim. This is necessary for authentication within the VoicePing platform.
The email address defined in the IdP must match the one used when registering the user in VoicePing.
This should be set by default in Microsoft Entra ID, but add it if not configured.
Add users to the created VoicePing app.
1. Open the "Users and groups" page from the VoicePing app in Microsoft Entra ID
2. Click "Add user/group"
3. Select users or groups you want to grant access to
4. Click "Select" and "Assign"
Ensure that added users have set up their email addresses in Microsoft Azure.
Download the metadata file from the IdP (Microsoft Entra ID). This file will be used later on the VoicePing side.
***
## VoicePing Configuration
Go to the workspace management dashboard, open the "Team Management > SSO Settings" tab, and enable SSO.
Switch to the Identity Provider tab. Select Microsoft Entra ID as the IdP, upload the IdP metadata file, and submit changes.
The metadata file can be obtained from Microsoft Entra ID.
Define the organization ID. This must be a unique string of at least 3 characters and maximum 20 characters.
The organization ID will be required from users when logging in with SSO.
Add users to the workspace. User email addresses must match the email addresses of users selected in the Microsoft Entra ID configuration.
Users can be added by either invitation or direct creation.
***
## Logging in with SSO
Once SSO is configured in the workspace:
* **Owners and Managers**: Can log in to VoicePing using other methods as well
* **Member Users**: Authentication via SSO is required
When you invite new VoicePing users to an SSO workspace, a VoicePing user account will be provided when the user signs up with SSO.
### Login Steps
1. Go to the VoicePing sign-in page
2. Click the "SSO Sign In" button
3. Enter organization ID
4. Authenticate on the Microsoft Entra ID authentication page
***