Keycloak: различия между версиями
Материал из Planfix
Artem (обсуждение | вклад) (Новая страница: «{{#seo: |title=Keycloak |titlemode=append |keywords=планфикс, Single Sign-On, Keycloak |description=Keycloak }} Интеграция с Keycloak позволяет сотрудникам вашей компании входить в ПланФикс с использованием единого пароля Single Sign-On (SSO). Это упрощает авторизацию, повышает безопасность и облегчает адм...») |
Artem (обсуждение | вклад) Нет описания правки |
||
(не показано 10 промежуточных версий этого же участника) | |||
Строка 5: | Строка 5: | ||
|description=Keycloak | |description=Keycloak | ||
}} | }} | ||
Интеграция с Keycloak позволяет сотрудникам вашей компании входить в ПланФикс с использованием единого пароля [[ | Интеграция с Keycloak позволяет сотрудникам вашей компании входить в ПланФикс с использованием единого пароля [[SSO]]. Это упрощает авторизацию, повышает безопасность и облегчает администрирование учетных записей. | ||
== Настройка Single Sign-On (SSO) == | == Настройка Single Sign-On (SSO) == | ||
=== | === Шаги в ПланФиксе === | ||
*Перейдите в раздел Управление аккаунтом — Интеграции — Single Sign-On. | *Перейдите в раздел Управление аккаунтом — Интеграции — Single Sign-On. | ||
*Активируйте интеграцию с Keycloak. | *Активируйте интеграцию с Keycloak. | ||
=== | === Шаги в Keycloak === | ||
*В новой вкладке откройте панель администрирования Keycloak. | *В новой вкладке откройте панель администрирования Keycloak. | ||
*Создайте или выберите существующий Realm. | *Создайте или выберите существующий Realm. | ||
Строка 19: | Строка 19: | ||
**General Settings: | **General Settings: | ||
***Client type: SAML | ***Client type: SAML | ||
***Client ID: | ***Client ID: скопируйте из настроек интеграции в ПланФиксе | ||
***Name: Planfix SAML APP | ***Name: Planfix SAML APP | ||
***Description: Planfix SAML APP | ***Description: Planfix SAML APP | ||
***Always display in UI: On | ***Always display in UI: On | ||
**Login Settings: | |||
***Root URL: скопируйте из настроек интеграции в ПланФиксе | |||
***Home URL: скопируйте из настроек интеграции в ПланФиксе | |||
***Valid redirect URIs: скопируйте из настроек интеграции в ПланФиксе | |||
***Valid post logout redirect URIs: (оставить пустым или настроить по необходимости) | |||
***IDP-Initiated SSO URL name: (необязательно) | |||
***IDP Initiated SSO Relay State: (необязательно) | |||
***Master SAML Processing URL: (необязательно) | |||
*После создания клиента, перейдите в его настройки и укажите: | |||
**Раздел Settings — SAML capabilities: | |||
***Name ID format: email | |||
**Раздел Signature and Encryption: | |||
***Sign documents: On | |||
**Раздел Keys — Signing keys config: | |||
***Client signature required: Off | |||
=== Финальный шаг === | |||
*Вернитесь в ПланФикс и в настройках интеграции с Keycloak заполните поле Metadata URI. | |||
<pre>https://{KEYCLOAK-URL}/realms/{REALM-NAME}/protocol/saml/descriptor</pre> | |||
Вместо переменных {KEYCLOAK-URL} и {REALM-NAME} подставьте значения из своего Keycloak. | |||
== Важно == | |||
*Убедитесь, что у пользователей есть доступ к соответствующему приложению в Keycloak. | |||
*При первой авторизации новая учетная запись будет создана автоматически через механизм JIT (Just-In-Time provisioning). | |||
== Перейти == | |||
*[[SSO]] | |||
*[[Интеграции]] |
Текущая версия от 13:07, 7 июля 2025
Интеграция с Keycloak позволяет сотрудникам вашей компании входить в ПланФикс с использованием единого пароля SSO. Это упрощает авторизацию, повышает безопасность и облегчает администрирование учетных записей.
Настройка Single Sign-On (SSO)
Шаги в ПланФиксе
- Перейдите в раздел Управление аккаунтом — Интеграции — Single Sign-On.
- Активируйте интеграцию с Keycloak.
Шаги в Keycloak
- В новой вкладке откройте панель администрирования Keycloak.
- Создайте или выберите существующий Realm.
- Перейдите в раздел Clients → Create client.
- Укажите следующие параметры:
- General Settings:
- Client type: SAML
- Client ID: скопируйте из настроек интеграции в ПланФиксе
- Name: Planfix SAML APP
- Description: Planfix SAML APP
- Always display in UI: On
- Login Settings:
- Root URL: скопируйте из настроек интеграции в ПланФиксе
- Home URL: скопируйте из настроек интеграции в ПланФиксе
- Valid redirect URIs: скопируйте из настроек интеграции в ПланФиксе
- Valid post logout redirect URIs: (оставить пустым или настроить по необходимости)
- IDP-Initiated SSO URL name: (необязательно)
- IDP Initiated SSO Relay State: (необязательно)
- Master SAML Processing URL: (необязательно)
- General Settings:
- После создания клиента, перейдите в его настройки и укажите:
- Раздел Settings — SAML capabilities:
- Name ID format: email
- Раздел Signature and Encryption:
- Sign documents: On
- Раздел Keys — Signing keys config:
- Client signature required: Off
- Раздел Settings — SAML capabilities:
Финальный шаг
- Вернитесь в ПланФикс и в настройках интеграции с Keycloak заполните поле Metadata URI.
https://{KEYCLOAK-URL}/realms/{REALM-NAME}/protocol/saml/descriptor
Вместо переменных {KEYCLOAK-URL} и {REALM-NAME} подставьте значения из своего Keycloak.
Важно
- Убедитесь, что у пользователей есть доступ к соответствующему приложению в Keycloak.
- При первой авторизации новая учетная запись будет создана автоматически через механизм JIT (Just-In-Time provisioning).