About SSO
Single Sign-On (SSO) allows your team members to log into Tina CRM using your organization’s identity provider. This provides:- Centralized access control: Manage access from one place
- Enhanced security: Leverage your existing security policies
- Better user experience: One set of credentials for all tools
Supported Providers
Tina CRM supports SSO with:- SAML 2.0: Works with most enterprise identity providers
- Google Workspace: For organizations using Google
- Microsoft Entra ID (formerly Azure AD): For Microsoft environments
Setting Up SSO
Prerequisites
- Organization plan (cloud and self-hosted workspaces)
- Admin access to your identity provider
- Admin access to your Tina CRM workspace
Configuration Steps
1. Access SSO Settings
- Go to Settings → Security
- Find the SSO Configuration section
- Click Configure SSO
2. Choose Your Provider
Select your identity provider from the list or choose “Custom SAML” for other providers.3. Configure Your Identity Provider
You’ll need to configure your identity provider with:- Entity ID: Provided by Tina CRM
- ACS URL: The callback URL for authentication
- Certificate: For secure communication
4. Enter Provider Details in Tina CRM
- SSO URL: Login URL from your provider
- Entity ID: Your provider’s identifier
- Certificate: X.509 certificate from your provider
5. Test and Enable
- Click Test Configuration to verify setup
- Enable SSO when testing is successful
- Configure user provisioning preferences
User Provisioning
Just-in-Time (JIT) Provisioning
- Users are created automatically on first login
- Users are assigned a default role automatically
- No manual user creation needed
Manual Provisioning
- Invite users before they can log in
- Pre-assign specific roles
- More control over who can access the workspace
Managing SSO Users
Role Assignment
SSO users can be assigned roles like regular users:- Go to Settings → Members
- Find the user
- Change their role as needed
Access Revocation
To remove access for SSO users:- Remove them from your identity provider, or
- Remove them from the Tina CRM workspace
Best Practices
Security
- Require SSO: Disable password login for SSO users
- Regular audits: Review access periodically
- Strong IdP policies: Enforce MFA at the identity provider
User Management
- Clear naming: Use consistent naming from your directory
- Group mapping: Map IdP groups to Tina CRM roles (if available)
- Offboarding process: Include Tina CRM in your deprovisioning workflow
Troubleshooting
Common Issues
- Certificate errors: Ensure the certificate hasn’t expired
- URL mismatches: Verify the ACS URL matches exactly
- User not found: Check JIT provisioning settings
Getting Help
If you encounter issues, contact support with:- Error messages received
- Identity provider being used
- Configuration details (without sensitive data)