Okta SSO

Acest ghid vă ghidează prin setarea SAML Single Sign-On între Okta și platformă.

Prerequisites

• Okta administrator access
• the platform organization administrator access
• Domeniul platformei dvs. (de exemplu, probo.example.com)
• Acces la setările DNS pentru verificarea domeniului

Prepare the platform Information

Înainte de a configura Okta, colectați următoarele detalii despre furnizorul de servicii al platformei:

Field	Value
ACS URL	https://your-probo-domain.com/api/connect/v1/saml/2.0/consume
Entity ID	https://your-probo-domain.com/api/connect/v1/saml/2.0/metadata

Înlocuiți your-probo-domain.com cu domeniul dvs. real al platformei.

Domain Verification

Înainte de a configura orice altceva, trebuie să verificați proprietatea domeniului:

1. Conectați-vă la platformă ca administrator organizațional
2. Go to Organization Settings → Authentication → SAML
3. Click Verify Domain (dacă nu există încă configurații, această opțiune va fi disponibilă)
4. Copy the provided TXT record value
5. Adăugați o înregistrare TXT la setările DNS ale domeniului dvs.:

   Type: TXT
   Name: _probo-domain-verification.your-company.com
   Value: [Verification token from Probo]
   TTL: 300 (or your DNS provider's default)

6. Wait for DNS propagation (usually 5-15 minutes)
7. In the platform, click Complete Verification
8. În caz de succes, statutul domeniului va fi afișat ca "Verificat"

Configure Okta

1. Semnează-te la dumneavoastră Okta Admin Console

2. Go to Applications → Applications

3. Click Create App Integration

4. Select SAML 2.0

5. Click Următorul

6. Configure the general settings:

   Field	Value
   App name	Probo
   App logo	Upload the platform logo (optional)
   App visibility	Check desired options

7. Click Următorul

8. Configure the SAML settings:

   Field	Value
   Single sign on URL	https://your-probo-domain.com/api/connect/v1/saml/2.0/consume
   Utilizați acest pentru URL-ul destinatar și URL-ul de destinație	☑️ (Check this box)
   Audience URI (SP Entity ID)	https://your-probo-domain.com/api/connect/v1/saml/2.0/metadata
   Default Relay State	[SAML Configuration ID] (optional - see note below)
   Name ID format	EmailAddress
   Application username	Email

   Important: The Default Relay State este opțional, dar dacă doriți să susțineți fluxurile de conectare inițiate de IdP, acesta trebuie să fie setat la ID-ul dvs. exact de configurare SAML (nu un locholder). Dacă setarea este incorectă, SSO nu va funcționa. Veți obține acest ID după crearea configurației SAML în platformă. Puteți lăsa inițial acest ID gol și îl puteți actualiza mai târziu cu ID-ul exact de configurare.

9. Add the following attribute statements:

   Name	Name format	Value
   email	Unspecified	user.email
   firstName	Unspecified	user.firstName
   lastName	Unspecified	user.lastName
   role	Unspecified	user.role (optional)

10. Click Următorul

11. Select Sunt un client Okta care adaugă o aplicație internă

12. Set App type A: Aplicație internă pentru angajați

13. Click Finish

14. Mergeţi la Sign On Tabăra aplicației dvs. de platformă

15. Click View SAML setup instructions

16. Save these values Pentru configurarea platformei:

    • Identity Provider Single Sign-On URL
    • Identity Provider Issuer
    • X.509 Certificate

17. Mergeţi la Assignments tab

18. Click Assign → Assign to People or Assign to Groups

19. Selectați utilizatorii / grupurile care ar trebui să aibă acces la platformă

20. Click Assign and Done

Configure the platform

1. Conectați-vă la platformă ca administrator organizațional

2. Go to Organization Settings → Authentication → SAML

3. Click Add SAML Configuration

4. Configure the basic settings:

   Field	Value	Notes
   Email Domain	your-company.com	Your organization’s email domain
   Enforcement Policy	OPTIONAL	Recommended for initial setup

5. Configurați setările furnizorului de identitate cu valori din Okta:

   Field	Value	Notes
   IdP Entity ID	[Identity Provider Issuer]	Copy from Okta setup
   IdP SSO URL	[Identity Provider Single Sign-On URL]	Copy from Okta setup
   IdP Certificate	[X.509 Certificate]	Copy from Okta setup

6. Configure the attribute mappings:

   Field	Value	Notes
   Email Attribute	email	Maps to user email
   First Name Attribute	firstName	Maps to user first name
   Last Name Attribute	lastName	Maps to user last name
   Role Attribute	role	Opțional; valori OWNER, ADMIN, EMPLOYEE, sau VIEWER

7. Configure user settings:

   Field	Value	Notes
   Auto Signup	Enabled	Permite noilor utilizatori să se înregistreze automat prin SSO

8. Click Save Configuration

9. Copy the SAML Configuration ID care apare după salvare (de exemplu, saml_config_1a2b3c4d)

Update Okta Relay State

Reveniți la Okta pentru a activa login-ul inițiat de IdP:

1. Accesați aplicația platforma în Okta Admin Console
2. Click General tab → Edit SAML Settings
3. In the Default Relay State field, enter your SAML configuration ID
4. Click Următorul → Următorul → Finish

Troubleshooting

“SAML assertion audience mismatch” Error

• CauseDispariția URI-ului audienței între Okta și platformă
• SolutionAsigurați-vă că URI-ul audienței din Okta se potrivește exact cu ID-ul entității:
  • Should be: https://your-probo-domain.com/api/connect/v1/saml/2.0/metadata

“User not assigned to application” Error

• CauseUtilizator care nu este atribuit aplicației platformei în Okta
• SolutionAtribuiți utilizator la aplicație în fila Octa's Assignments

Attributes Not Mapping

• Cause: Incorrect attribute statement names in Okta
• Solution: Verify attribute statement names match exactly: email, firstName, lastName

“Invalid RelayState” Error

• Cause: Incorrect Default Relay State configuration
• SolutionAsigurați-vă că Starea Relay Default este fie goală, fie setată la ID-ul exact de configurare SAML de pe platformă

Debugging Steps

Check Okta System Log

1. Go to Okta Admin Console → Reports → System Log
2. Filtru după denumirea aplicației (platforma)
3. Căutați erori de autentificare și detalii despre erori

Advanced Configuration

Custom Attributes

To map additional Okta user attributes:

1. În Okta, adăugați atribute personalizate la profilurile de utilizator
2. Adăugați declarații de atribute în configurația aplicației SAML
3. Maparea acestor atribute în configurația platformei SAML

Group-Based Access

Control access using Okta groups:

1. Crearea de grupuri în Okta pentru accesul la platformă
2. Assign users to appropriate groups
3. Atribuirea aplicației platformei la grupuri în loc de utilizatori individuali
4. Use group filters for fine-grained access control

Pentru rezolvarea detaliată a problemelor și opțiuni avansate de configurare, consultați SSO Overview guide.