These settings can be found in the selected directory in Becard Enterprise under "SSO / SAML2".
The SAML integration allows users to securely sign in to Becard through your central Identity Provider (IdP).
Supported Identity Providers:
- Microsoft Entra ID
- Okta
- Google Workspace
- Keycloak
- Auth0
- OneLogin
- Ping Identity
- Other SAML 2.0-compatible providers
Prerequisites
To set this up, you need:
- An active Becard Enterprise environment
- Administrator rights in the Identity Provider
- Access to the SAML settings in Becard
- A configured Identity Provider with SAML 2.0 support
Open the SAML settings in Becard
- Open your Becard Enterprise dashboard
- Navigate to:
DirectorySAML
- Enable:
SAML Single Sign-On
Required information from your Identity Provider
The following data is required for the connection:
| Field | Description |
|---|---|
| Login URL | SAML login endpoint of your Identity Provider |
| Entity ID | Entity ID / identifier of your Identity Provider |
| X509 certificate | Public SAML certificate |
| Logout URL | Optional logout endpoint |
Enter the SAML configuration in Becard
Enter your Identity Provider's data in Becard.
Example
| Field | Example |
|---|---|
| Login URL | https://login.microsoftonline.com/.../saml2 |
| Entity ID | https://sts.windows.net/... |
| Logout URL | https://login.microsoftonline.com/.../logout |
Add the certificate
- Copy the public X509 certificate of your Identity Provider
- Paste the certificate into Becard
The certificate is used to validate SAML responses.
Assertion Consumer Service (ACS) URL
Your Identity Provider requires the Becard ACS URL.
Example:
https://enterprise.becard.me/auth/saml/callback
Becard Entity ID
Use the following Entity ID in your Identity Provider:
https://enterprise.becard.me
NameID format
Recommended format:
emailAddress
The email address serves as the unique user identifier.
Configure user attributes
Recommended attributes:
| SAML attribute | Becard field |
|---|---|
| Email address | |
| givenName | First name |
| surname | Last name |
| displayName | Display name |
Test the login
- Save the configuration
- Open the SSO login page
- Sign in with a user from your Identity Provider
After a successful login, the user is automatically signed in to Becard.
Just-in-Time (JIT) user provisioning
Optionally, Becard can automatically create users when they sign in via SAML for the first time.
The following are transferred automatically:
- First name
- Last name
- Email address
- Display name
Single Logout (SLO)
You can optionally enable Single Logout.
This also automatically signs users out of Becard when they sign out of the Identity Provider.
Common errors
Invalid Signature
Check the following:
- Certificate inserted correctly
- Certificate is current
- No additional spaces
User not found
Check the following:
- Email address is being transferred
- User exists
- NameID configured correctly
ACS URL error
Check the following:
- ACS URL copied exactly
- HTTPS used
- No typing errors
Login does not work
Check the following:
- Entity ID is correct
- Login URL is correct
- User assigned to the application
Security notices
Recommended:
- Use signed assertions
- Renew certificates regularly
- Always use HTTPS
- Restrict access to authorised domains
Support
If you need assistance setting this up, please contact Becard Support.
Comments
0 comments
Please sign in to leave a comment.