Иу хатт бахизыны (SSO) конфигурацийӕ SAML кӕнӕ OIDC-имӕ

ScribbleMaps ӕххуыс кӕны предприятитӕн иу хатт бахизынмӕ, пайда кӕнгӕйӕ SAML 2.0 кӕнӕ OpenID Connect (OIDC). Уый дӕ командӕйы уӕнгтӕн ныххӕлиу кӕны, цӕмӕй хи ӕвдисой дӕ организацийы Identity Provider (IdP)-ӕй, куыд Okta, Microsoft Entra ID (Azure AD), Google Workspace кӕнӕ Auth0.

SSO-йы конфигурацийӕ ис team.scribblemaps.com-ы ӕмӕ уый ӕгънӕг мыздӕй нӕу.

Мидисы рӕгъ

1. Ӕххуыс кӕнӕг фадӕттӕ
2. Раздӕр, ӕмӕ байдайай
3. 1 къахдзӕф: Дӕ email-ы домен сбӕлвырд кӕн
4. 2 къахдзӕф: Дӕ Identity Provider сфӕтк кӕн
5. 3 къахдзӕф: SSO сфӕтк кӕн ScribbleMaps-ы
6. 4 къахдзӕф: Дӕ конфигурацийӕ равзар
7. 5 къахдзӕф: SSO бацӕттӕ кӕн
8. SP-ӕй райдайӕн SSO
9. OIN Universal Logout
10. Провайдеры ном-ӕй разамындтытӕ
11. Фылдӕр фадӕттӕ
12. Рӕдыдтӕ арӕзт кӕнын

Ӕххуыс кӕнӕг фадӕттӕ

ScribbleMaps SSO-йы интеграцийӕ ӕххуыс кӕны ацы фадӕттӕн:

Раздӕр, ӕмӕ байдайай

• SSO сфӕтк кӕнынӕн дӕ хъӕуы уӕвын Team Owner
• Дӕ хъӕуы бахизын дӕ организацийы Identity Provider-ы администраторон консолмӕ
• Дӕ email-ы домен ӕрцӕттӕ кӕн (куыд, yourcompany.com)

1 къахдзӕф: Дӕ email-ы домен сбӕлвырд кӕн

SSO сфӕтк кӕныны раздӕр дӕ хъӕуы сбӕлвырд кӕнын дӕ email-ы домены хицаудзинад. Ацы ӕдасдзинады мадзал ӕнхъӕлмӕ кӕны, цӕмӕй SSO сфӕтк кӕной сӕхи доменӕн ӕрмӕст сӕрибар организацитӕ.

1. Бахиз team.scribblemaps.com-мӕ
2. Ацу Ӕвӕрдтытӕ > Иу хатт бахизын-мӕ
3. Ацу Домӕнтӕ табмӕ
4. Ныкъхъырцы кӕн Домен бафтауын-ыл ӕмӕ ныффысс дӕ email-ы домен (куыд, yourcompany.com)
5. Равзар сбӕлвырд кӕныны фӕрӕз:

А фӕрӕз: DNS TXT record (Мӕнӕ уымӕн дзурынц)

Дӕ домены DNS ӕвӕрдтытӕм бафтау TXT record:

Фиппаинаг: DNS-ы ивддзинӕдтӕ тӕрсынц 48 сахаты онг.

Б фӕрӕз: Файл бавгӕнын

1. Саразын текстон файл ном scribblemaps-verify.txt-имӕ
2. Йӕ мидисыл ныффысс ӕрмӕст дӕ сбӕлвырд кӕныны код
3. Бавгӕн ардӕм: https://yourcompany.com/.well-known/scribblemaps-verify.txt

Сбӕлвырд кӕнынад бафтауыны фӕстӕ ныкъхъырцы кӕн Домен сбӕлвырд кӕнын-ыл хицаудзинад бӕлвырд кӕнынӕн.

2 къахдзӕф: Дӕ Identity Provider сфӕтк кӕн

Дӕ Identity Provider-ы ScribbleMaps бафтау куыд application. Кӕд Okta пайда кӕныс, ӕмӕ ScribbleMaps бафтауын ис ӕвгъау Okta Integration Network (OIN) каталогӕй — SAML SSO URL, SP Entity ID, ACS URL ӕмӕ OIDC Redirect URI автоматикӕй разӕвӕрд ысты.

SAML 2.0 -ӕн

OIDC-ӕн

3 къахдзӕф: SSO сфӕтк кӕн ScribbleMaps-ы

SAML 2.0 сфӕтк кӕнын

1. ScribbleMaps-ы ацу Ӕвӕрдтытӕ > Иу хатт бахизын > SAML таб
2. Ныффысс ацы информаци дӕ Identity Provider-ӕй:

3. Ныкъхъырцы кӕн Уагӕвӕрдтӕ бафснайын-ыл

OIDC сфӕтк кӕнын

1. ScribbleMaps-ы ацу Ӕвӕрдтытӕ > Иу хатт бахизын > OIDC таб
2. Равзар дӕ Provider Type (Google, Microsoft, Okta, Auth0 кӕнӕ Хи)
3. Ныффысс ацы информаци:

4. Ныкъхъырцы кӕн Уагӕвӕрдтӕ бафснайын-ыл

4 къахдзӕф: Дӕ конфигурацийӕ равзар

Иууылдӕр пайдагӕнджытӕн SSO бацӕттӕ кӕныны раздӕр дӕ конфигурацийӕ равзар:

1. Ныкъхъырцы кӕн Test Connection тугъдыл
2. Ног рӕгъау байгом уыдзӕн SSO-бахизыны фӕрӕзы ӕвзӕрстадӕн
3. Сӕххӕст кӕн аутентификаци дӕ Identity Provider-имӕ
4. Бӕлвырд кӕн, цӕмӕй ӕнӕкӕрон ӕрцыдтӕ ScribbleMaps-мӕ

Кӕд равзарын рӕдыд у, ныффидар кӕн рӕдыды хабар ӕмӕ дӕ конфигурацийы ӕвӕрдтытӕ ныффӕлвар.

5 къахдзӕф: SSO бацӕттӕ кӕн

Иу хатт равзарын ӕнӕкӕрон куы разына:

1. Ивд кӕн Enable SSO ивӕнтӕ ON-мӕ
2. Равзар дӕ ницӕйаг фадат:
   • Optional: Пайдагӕнджытӕ равзарын ӕрмӕст SSO кӕнӕ пароль-бахизын
   • Enforced: Сбӕлвырд email-доменимӕ пайдагӕнджытӕ хъуамӕ пайда кӕной SSO (пароль-бахизын хӕстӕг у)

Фиппаинаг: Team Owners-ты ӕгад фӕрӕстӕй пайда кӕнын ис пароль-бахизынӕй дӕр, кӕд SSO enforced дӕр у.

SP-ӕй райдайӕн SSO

ScribbleMaps ӕххуыс кӕны SP-ӕй райдайӕн SSO-йӕн, уый пайдагӕнджытӕн фадат дӕтты бахизыны процесс райдайын ScribbleMaps-ы бахизыны фарсӕй. Афтӕ у:

1. Ацу scribblemaps.com/account/login-мӕ
2. Ныффысс дӕ email адрес (куыд, [email protected])
3. Ныкъхъырцы кӕн Sign in with SSO-ыл
4. Дӕ организацийы Identity Provider-мӕ (куыд, Okta) дӕ ратт кӕндзысты аутентификацийӕн
5. Ӕнӕкӕрон аутентификацийы фӕстӕ дӕ автоматикӕй раздӕхтӕ кӕнынц ScribbleMaps-мӕ ӕмӕ бахизыс

Кӕд дӕ организацийы SSO enforced у, бахизыны фарсыл дӕ email куы ныффыссай, уӕд дӕ автоматикӕй раттӕг кӕндзысты дӕ Identity Provider-мӕ — пароль-ы бынат нӕ ӕвдисдзысты.

OIN Universal Logout

Okta-йы Universal logout ӕххуыс кӕны. Сфӕтк кӕныны инструкцитӕн ныккӕс ацы ссылкӕмӕ.

Провайдеры ном-ӕй разамындтытӕ

Okta

1. Okta Admin Console-ы ацу Applications > Browse App Catalog-мӕ
2. Агур ScribbleMaps ӕмӕ ныкъхъырцы кӕн Add Integration-ыл
3. SSO URL, Entity ID ӕмӕ Redirect URI автоматикӕй разӕвӕрд ысты
4. Ацу Sign On табмӕ дӕ IdP-ы конфигурацийы бӕлвырдтӕ ссарынӕн:
   • Ӕрбавгӕн X.509 Certificate
   • Рафысс Identity Provider Issuer (Entity ID)
   • Рафысс Single Sign-On URL
5. Ацы аргътӕ ныффысс ScribbleMaps-ы SSO ӕвӕрдтытӕм (кӕс 3 къахдзӕф)

Microsoft Entra ID (Azure AD)

1. Azure Portal-ы ацу Microsoft Entra ID > App registrations > New registration-мӕ
2. Сфӕтк кӕн:
   • Redirect URI: https://api.scribblemaps.com/oidc/callback (Web platform)
3. Ацу Certificates & secrets-мӕ > Саразын ног Client secret
4. Рафысс Application (client) ID ӕмӕ Client secret value
5. Authority URL: https://login.microsoftonline.com/YOUR-TENANT-ID/v2.0

Google Workspace

1. Google Cloud Console-ы ацу APIs & Services > Credentials-мӕ
2. Ныкъхъырцы кӕн Create Credentials > OAuth client ID-ыл
3. Равзар Web application
4. Бафтау Authorized redirect URI: https://api.scribblemaps.com/oidc/callback
5. Рафысс Client ID ӕмӕ Client Secret
6. Authority URL: https://accounts.google.com

Фиппаинаг: Google Workspace-ы MFA домынӕн, ӕй сфӕтк кӕн дӕ Google Workspace Admin Console-ы.

Auth0

1. Auth0 Dashboard-ы ацу Applications > Create Application-мӕ
2. Равзар Regular Web Applications
3. Сфӕтк кӕн:
   • Allowed Callback URLs: https://api.scribblemaps.com/oidc/callback
   • Allowed Logout URLs: https://api.scribblemaps.com/oidc/logout-callback
4. Рафысс Client ID ӕмӕ Client Secret Ӕвӕрдтытӕ табӕй
5. Authority URL: https://YOUR-DOMAIN.auth0.com

Фылдӕр фадӕттӕ

Just-In-Time (JIT) провижининг

Куы бацӕттӕ кӕнай, уӕд пайдагӕнджытӕ автоматикӕй ӕвзӕрст вӕййынц ScribbleMaps-ы сӕ фыццаг SSO-бахизыны рӕстӕг. Сӕ профилы информаци (ном, email) райсынц Identity Provider-ӕй.

Бирӕ факторон аутентификаци домын (OIDC-ӕн ӕрмӕст)

Ацы фадат бацӕттӕ кӕн, цӕмӕй бахизыны разӕй домай MFA-ы сбӕлвырд кӕнын. ScribbleMaps бӕлвырд кӕндзӕн, ӕмӕ дӕ IdP-ы пайдагӕнӕгӕн MFA ныффидар кодта.

Okta-ӕн ис раттын хи ACR аргътӕ, куыд:

• urn:okta:loa:2fa:any - Кӕцыфӕнды дыккаг фактор
• phr - Phishing-ӕй хъахъхъӕнӕг аутентификаци
• phrh - Phishing-ӕй хъахъхъӕнӕг hardware-ӕй баст аутентификаци

Атрибут/Claim-ы ӕвзӕрст

Ӕвзар хи уагӕй, куыд дӕ IdP-ы пайдагӕнӕджы атрибуттӕ ӕнцой кӕнынц ScribbleMaps-ы пайдагӕнӕджы fields:

Рӕдыдтӕ арӕзт кӕнын

Хуымӕтӕг проблемӕтӕ

"Domain not verified"

• Бӕлвырд кӕн, цӕмӕй дӕ DNS TXT record кӕнӕ сбӕлвырд кӕныны файл ӕнӕрӕдыд сфӕтк у
• DNS-ы ивддзинӕдтӕ тӕрсынц 48 сахаты онг
• Бӕлвырд кӕн, цӕмӕй сбӕлвырд кӕныны кодӕй нӕй рӕдыдтӕ

"Invalid certificate"

• Бӕлвырд кӕн, цӕмӕй пайда кӕныс комплектон certificate-ӕй, ӕмбӕлы -----BEGIN CERTIFICATE----- ӕмӕ -----END CERTIFICATE----- дӕр
• Ныффӕлвар, certificate-ы ӕппӕт рӕстӕг ӕнӕ байрох ис
• Бӕлвырд кӕн, цӕмӕй рафыстай signing certificate, нӕ encryption certificate

"Invalid signature"

• Бӕлвырд кӕн, цӕмӕй certificate дӕ IdP-ы ныры signing certificate-имӕ ӕмвӕзад у
• Ныффӕлвар, signature algorithm ӕмвӕзад у (SHA-256 кӕнӕ SHA-1)

"User not found" кӕнӕ "Email mismatch"

• Бӕлвырд кӕн, цӕмӕй дӕ IdP-ӕй раздӕхт email сбӕлвырд доменимӕ ӕмвӕзад у
• Ныффӕлвар, NameID format Email Address у
• Бӕлвырд кӕн, цӕмӕй атрибут/claim-ы ӕвзӕрст ӕнӕрӕдыд у

"Security error: Your Identity Provider is not authorized for this email domain"

• Уый вӕййы, куы IdP-ы конфигурацийӕ сбӕлвырд доменимӕ нӕ ӕмвӕзад
• Бӕлвырд кӕн, цӕмӕй email-ы домен дӕ командӕйы бынӕй сбӕлвырд у
• Ныффӕлвар, цӕмӕй бахизыс email-имӕ сбӕлвырд доменӕй

Аудит-логтӕ кӕсын

Ныккӕс SSO-йы ӕгъдау Ӕвӕрдтытӕ > Иу хатт бахизын > Audit Logs-ы. Ис дӕ:

• Фильтр кӕнын событийы хуызӕй (Login, Logout, Failed Login)
• Фильтр кӕнын датӕйы диапазонмӕ гӕсгӕ
• Логтӕ экспорт кӕнын CSV-ы хуызы compliance-ы рапортӕн

Ӕххуыс хъӕуы?

Кӕд SSO-йы конфигурацийы проблемӕтӕ ис, уӕд скъуыд кӕн нӕ ӕххуысы командӕйы ацы информацийӕ:

• Дӕ Командӕйы ном
• Identity Provider, цы пайда кӕныс
• Цы рӕдыды хабӕрттӕ уынис
• Дӕ IdP-ы конфигурацийы скриншоттӕ (ӕдасдзинады информацийӕ бӕрӕг нӕ вӕййы)

Мах ам стӕм, цӕмӕй дӕ ӕххуыс кӕнӕм дӕ организацийӕн SSO сфӕтк кӕнынӕн.