Интеграция с Google Single Sign-On

Введение

Настройте интеграцию Google Single sign-on (SSO), чтобы выполнять вход в 3CX с аккаунтами Google по технологии единого входа.

Шаг 1: Создайте проект Google Project

Create Google SSO project

  1. Зайдите в Google Console с вашим личным или корпоративным аккаунтом Google.
  2. Нажмите "CREATE PROJECT" и укажите информацию о проекте:
  1. ‘Project name’ - название проекта, например, pbx-integration.
  2. ‘Location’ - выберите организацию, если необходимо.
  1. Нажмите "Create".

Шаг 2: Настройте приложение OAuth Consent Screen

Теперь настройте приложение OAuth Consent Screen для проекта.

Configure Google API

  1. Перейдите в раздел "APIs & services" > "OAuth consent screen".
  2. Выберите соответствующий ‘User Type’ и нажмите “CREATE”.
  1. ‘Internal’ - в этом режиме вход SSO доступен только пользователям Google Workspace вашей организации.
  2. ‘External’ - в этом режиме для входа в 3CX можно использовать аккаунты Google, не принадлежащие вашей организации.
  1. В поле ‘App information’ укажите название приложения (например, PBX Integration) и из выпадающего списка выберите e-mail для техподдержки.
  2. Прокрутите до раздела ‘Developer contact information’ и введите адрес e-mail.
  3. Нажмите “Save and Continue”.
  4. На следующем экране ‘Scopes’, прокрутите вниз и нажмите “Save and Continue”.
  5. В разделе ‘Test users’ нажмите “Save and Continue”. Нажмите “Back to Dashboard”.
  6. Если вы указали ‘User Type’ как ‘External’, нажмите “PUBLISH APP” и “CONFIRM”.

Publish app if External was selected

Шаг 3: Получите 3CX URI

3CX URI link

  1. Перейдите в консоль управления 3CX
  2. Зайдите в систему как ‘System Administrator’ или ‘System Owner’. Подробнее о ролях безопасности.
  3. Перейдите в “Settings > Integrations > Google”.
  4. На вкладке ‘Configure’ прокрутите вниз до шага 10 и зафиксируйте (скопируйте) ссылку интеграции 3CX.

Шаг 4: Завершите установку Google URI

Add 3CX URI in Google Console

  1. Снова зайдите в Google Console и выберите “Credentials”.
  2. Нажмите “+ Create Credentials” и выберите из списка “OAuth client ID”.
  3. В выпадающем списке для ‘Application type’ выберите “Web application”.
  4. Введите название (например, PBX Integration), прокрутите вниз до раздела ‘Authorised redirect URIs’ и нажмите “+ ADD URI”.
  5. Вставьте скопированную ранее ссылку интеграции 3CX и нажмите “CREATE”.
  6. Зафиксируйте ‘Client ID’ и ‘Client Secret’ и нажмите “OK”.

Шаг 5: Завершите настройку на стороне 3CX

  1. Снова зайдите в консоль управления 3CX и вставьте ваши ‘Client ID’ и ‘Client Secret’ в соответствующие поля.
  2. Нажмите “Save”.
  3. Google SSO будет автоматически включен для всех пользователей.
  4. Если вы хотите отключить SSO для определенных пользователей, это делается на странице “User > Options”.

Дополнительная информация

Версия документа

Последнее обновление документа 27 февраля 2024

https://www.3cx.ru/docs/manual/google-sso/