Keycloak: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
(Новая страница: «{{#seo: |title=Keycloak |titlemode=append |keywords=планфикс, Single Sign-On, Keycloak |description=Keycloak }} Интеграция с Keycloak позволяет сотрудникам вашей компании входить в ПланФикс с использованием единого пароля Single Sign-On (SSO). Это упрощает авторизацию, повышает безопасность и облегчает адм...»)
 
Нет описания правки
 
(не показано 10 промежуточных версий этого же участника)
Строка 5: Строка 5:
|description=Keycloak
|description=Keycloak
}}
}}
Интеграция с Keycloak позволяет сотрудникам вашей компании входить в ПланФикс с использованием единого пароля [[Single Sign-On (SSO)]]. Это упрощает авторизацию, повышает безопасность и облегчает администрирование учетных записей.
Интеграция с Keycloak позволяет сотрудникам вашей компании входить в ПланФикс с использованием единого пароля [[SSO]]. Это упрощает авторизацию, повышает безопасность и облегчает администрирование учетных записей.


== Настройка Single Sign-On (SSO) ==
== Настройка Single Sign-On (SSO) ==
=== '''Шаги в ПланФиксе''' ===
=== Шаги в ПланФиксе ===
*Перейдите в раздел Управление аккаунтом — Интеграции — Single Sign-On.
*Перейдите в раздел Управление аккаунтом — Интеграции — Single Sign-On.
*Активируйте интеграцию с Keycloak.
*Активируйте интеграцию с Keycloak.


=== '''Шаги в Keycloak''' ===
=== Шаги в Keycloak ===
*В новой вкладке откройте панель администрирования Keycloak.
*В новой вкладке откройте панель администрирования Keycloak.
*Создайте или выберите существующий Realm.
*Создайте или выберите существующий Realm.
Строка 19: Строка 19:
**General Settings:
**General Settings:
***Client type: SAML
***Client type: SAML
***Client ID: https://test.planfix.com/saml2/service-provider-metadata/keycloak
***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: (необязательно)
  • После создания клиента, перейдите в его настройки и укажите:
    • Раздел Settings — SAML capabilities:
      • Name ID format: email
    • Раздел Signature and Encryption:
      • Sign documents: On
    • Раздел Keys — Signing keys config:
      • Client signature required: Off

Финальный шаг

  • Вернитесь в ПланФикс и в настройках интеграции с Keycloak заполните поле Metadata URI.
https://{KEYCLOAK-URL}/realms/{REALM-NAME}/protocol/saml/descriptor

Вместо переменных {KEYCLOAK-URL} и {REALM-NAME} подставьте значения из своего Keycloak.

Важно

  • Убедитесь, что у пользователей есть доступ к соответствующему приложению в Keycloak.
  • При первой авторизации новая учетная запись будет создана автоматически через механизм JIT (Just-In-Time provisioning).

Перейти