Для подключения приложения необходимо выполнить семь простых действий. Открыть Настройки, то Безопасность, выбрать Идентификация и вход в систему, то Подключенные приложения, и нажмите Подключить приложение. Вам нужна Управление подключенными приложениями разрешение.
Ничто не сохраняется, пока Подключите приложение на шаге 6, и никто не будет затронут, пока кто-то не войдет в приложение.
Подключить приложение
Справа от шагов 2, 4 и 6 вы видите изображение страницы, которую люди увидят при первом входе в систему, на основе вашего выбора. Она меняется по мере вашего движения.
Шаг 1: Выберите, что вы подключаете
Выберите продукт: WordPress, Grafana, Дискуссия, Мудл, Некстклауд, Маттермост, Zapier или Марка. Kamo тогда знает свой обратный адрес, разрешения, которые ему обычно нужны, и точные шаги, чтобы закончить в нем.
Не в списке? Выберите Пользовательский веб-сайт для сайта с собственным сервером, Одностраничное приложение для веб-приложения, которое работает в браузере (React, Vue и т.д.), Мобильное приложение для iPhone, Android или настольного приложения, ТВ или устройство для телевизора, экрана в зале заседаний или инструмента командной строки, или Приложение SAML для приложения, которое выполняет вход с помощью единого входа SAML. Сервис Back-End, для программы, которая входит в систему от своего имени, появится позже.
Приложение для телевизора или устройства и приложение SAML выполняют несколько различные действия, описанные ниже.
Шаг 2: Имя и логотип
Имя и логотип, которые люди видят на страницах входа и разрешений, чтобы знать, какое приложение просит разрешения. Логотип необязателен: укажите адрес https:// квадратного изображения или оставьте его пустым, чтобы использовать собственный знак продукта. Одностороннее описание отображается при первом входе в систему.
Шаг 3: Адреса возврата
После входа в систему Kamo отправляет пользователя обратно в приложение, но только на адрес, указанный в списке, сравнивая адреса букву за буквой. Таким образом, никто не сможет выдавать себя за ваше приложение и перехватить вход в систему по пути.
Адреса должны начинаться с https://. Мобильные и настольные приложения также могут использовать собственный адрес, например com.yourcompany.app:/callbackили http://127.0.0.1 на любом порту.
Адрес вашего сайта
Для WordPress, Grafana, Discourse, Moodle, Nextcloud и Mattermost введите адрес, который люди используют, чтобы добраться до продукта, например https://blog.yourcompany.com. Kamo создает точный обратный адрес, используемый продуктом из него. Для Make нет ничего вводить. Для Zapier, пользовательского веб-сайта, одностраничного приложения или мобильного приложения вставьте обратный адрес, который предоставляет вам приложение или ваш разработчик.
Вы можете добавить больше адресов, например, для тестовой копии сайта.
Адреса выхода
Под Дополнительные параметры выхода: куда люди могут быть отправлены после выхода из приложения. Оставьте это поле пустым, если приложение не выводит людей из Kamo. Для Grafana, Kamo заполнит его за вас.
Уведомления о выходе
Также в рамках Дополнительные параметры выхода, для веб-сайтов: когда кто-то выходит из Kamo, Kamo может сообщить приложению по этому адресу, чтобы оно также вышло. Приложение должно поддерживать back-channel выключение; у большинства нет, и его можно оставить пустым.
Войти на телевизоре или устройстве
В конце действия 3 для веб-сайта, одностраничного приложения или мобильного приложения включите Войти на телевизоре или устройстве чтобы позволить людям также войти в то же приложение на телевизоре, экране или инструменте командной строки, утвердив короткий код на своем телефоне. Оставьте это выключенным, если только разработчик приложения не попросит об этом. См Войти на телевизоре или устройстве за то, что люди видят.
Как приложение отправляет свой секрет
Для веб-сайтов: как приложение доказывает свою личность при сборе данных для входа в систему Базовый, если только инструкции приложения не говорят "секретный пост клиента".
Шаг 4: Что видно в приложении
Каждый переключатель является одной из вещей, которые приложение может узнать о человеке, входящем в систему:
- Вход: что это один и тот же человек каждый раз. Всегда на.
- Имя и профиль: их имя, имя пользователя, часовой пояс и язык.
- электронная почта: их адрес электронной почты. Большинство приложений нуждаются в этом, чтобы распознать людей, которые уже имеют учетную запись там.
- Телефон: номер телефона в их профиле.
- Организация: к какой организации они принадлежат и являются ли они ее сотрудниками или клиентами.
- Роли и команды: их роли, отдел, должность и команды, так что приложение может дать им правильный доступ.
- Оставайтесь в системе: приложение может продолжать работать для них, когда они отсутствуют, до тех пор, пока доступ не будет отнят. Zapier, Make и мобильные приложения нуждаются в этом.
Приложение должно получать только то, что ему нужно. Этот список отображается при первом входе в систему.
Работа с Kamo данными
Под разрешениями на вход, Работа с Kamo данными позволяет приложению читать или изменять Kamo данные для человека, который вошел в систему, через Kamo API или AI помощника. Это необязательно; большинству приложений, которые только вводят данные, это не нужно. У каждого типа данных (контакты, потенциальные клиенты, календарь, электронная почта, заметки и контрольные списки, документы, база знаний и встречи) есть свой Зеркало переключатель и Изменение переключатель, и каждый из них говорит, какое Kamo разрешение нужно человеку, например Посмотреть контакты.
- Приложение никогда не может делать больше, чем человек может сделать в Kamo. Кто-то без разрешения просто не дает приложению эту часть, и ничего не сломается.
- Если кто-то позже потеряет разрешение Kamo, то и приложение потеряет его.
- Приложение никогда ничего не может удалить.
Разработчики найдут полный список этих разрешений с их техническими названиями в Создание приложения на входе вашей организации.
Приложения для телевизора или устройства
А/АС.109/2004/1 ТВ или устройство приложение не имеет обратных адресов: никто не вводит пароль на устройстве. Он показывает короткий код и адрес; человек открывает адрес на своем телефоне или компьютере, проверяет код и нажимает Разрешить, и устройство заканчивает вход в себя. Его шаг 3 Как он входит, который показывает адрес, по которому люди вводят код.
Люди всегда видят экран проверки кода, даже для приложения, которое вы предварительно утвердили, поэтому никого нельзя обмануть, чтобы утвердить устройство, которого у них нет.
Может ли устройство хранить секрет?
Большинство телевизоров и инструментов командной строки не могут хранить секретный сейф, потому что любой, у кого есть устройство, может его прочитать Нет, это не может для тех. Выберите Да, в заголовке (или Да, в форме, если в программном обеспечении устройства указано «секретный пост клиента») только для устройства, которым вы управляете и которое безопасно хранит секрет. Это нельзя изменить после подключения приложения.
Приложения SAML
А/АС.109/2004/1 Приложение SAML имеет свое Настройки SAML шаг вместо возврата адресов и разрешений. Скопируйте, что ему нужно с собственной страницы настроек SAML или единого входа приложения:
- Тип Детали: приложение Идентификационный номер субъекта (также называемый Audience, Issuer или SP Entity ID) и его Адрес ответа (URL-адрес ACS), который должен начинаться с https://. Можно добавить до десяти.
- Золотая Вставьте метаданные приложения (ниже).
- Идентификация людей по: Адрес электронной почты (что большинство приложений хотят), Постоянные, Не указано или Переходный период.
- Атрибуты: факты, которые приложение получает, каждый под именем, которое приложение ожидает. Новые приложения отправляют электронную почту, firstName, lastName и displayName.
- Подписать весь ответ (на) и Можно открыть из запуска приложений (выкл.), ниже.
Кто может использовать его, и спрашивать первый или предварительное утверждение, работать как для любого приложения. Последний шаг показывает, что дать приложение; см Использование организации в качестве поставщика удостоверений SAML.
Вставьте метаданные приложения
Многие приложения предлагают свои настройки SAML в виде файла метаданных или текста XML. Вставьте все, и Kamo считает из него идентификатор субъекта, адреса ответов и сертификат подписи приложения. Когда вы измените приложение позже, оставьте поле пустым, чтобы сохранить его содержание.
Идентификация людей по
Что приложение получает в качестве идентификатора человека. Адрес электронной почты адрес электронной почты пользователя; Постоянные это номер, который никогда не меняется для этого человека и этого приложения; Не указано отправляет электронную почту для приложений, которые не возражают против формата; Переходный период новый номер при каждом входе в систему.
Атрибуты
Каждая строка представляет собой один факт, который получает приложение: Имя в приложении (без пробелов, точно так, как говорится в документации приложения) и Что она несет (электронная почта, имя, фамилия или полное имя, номер члена, отдел, должность, роли, команды или название вашей организации). Вернуться к обычной четверке восстанавливает настройки по умолчанию.
Подписать весь ответ
Каждый вход Kamo отправляется подписанным. При включении этого параметра, весь ответ также подписывается, что и ожидается большинством приложений. Отключите его только в том случае, если это указано в документации приложения.
Можно открыть из запуска приложений
Обычно люди начинают с приложения, которое направляет их на Kamo для входа в систему. Включите эту опцию, чтобы позволить людям открывать приложение со ссылки или запуска, используя его Адрес запуска, и выберите Страница по умолчанию если вам нравится. Оставьте его выключенным, если документация приложения не просит об этом.
Шаг 5: Кто может использовать его
Для вашей команды, выберите Все, Некоторые люди или Никто. с Некоторые люди, выбрать отделы, должности и команды, и добавить людей по имени; кто-то может использовать приложение, если они соответствуют любому из них.
Клиенты
Клиенты - это люди, которых обслуживает ваша организация, но которые не входят в состав вашей команды, например, заемщики или пациенты Нет клиентовВыберите Все клиенты или Некоторые клиенты для приложения, предназначенного для них, например, портала клиента.
Шаг 6: Сначала спросите или предварительно утвердите
Сначала спросите каждого человека показывает людям, что приложение будет учиться и позволяет им сказать нет, в первый раз. Предварительное утверждение для всех Пропускает вопрос, потому что вы решили за всех. Предварительно утвердить свои собственные инструменты компании; спросите сначала о том, что клиенты используют.
Частный номер участника
Обычно каждое приложение видит один и тот же номер для человека Дайте этому приложению частный номер участника и это приложение получает свой собственный номер для каждого человека вместо этого, так что два приложения не могут соответствовать одному и тому же человеку. Большинству приложений это не нужно.
Пресса Подключите приложение (или Сохранить изменения при редактировании).
Шаг 7: закончить в приложении
Приложение подключено.
- 2.2.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1 Идентификатор клиента, что даёт вашему приложению имя Kamo. Это не секрет.
- 2.2.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1 Секрет клиента для веб-сайта (см. ниже).
- Точные шаги, чтобы закончить в продукте, с каждым значением заполнены и кнопка копирования рядом с каждым из них.
- Образцы кода в Node, Python и PHP (и в браузере, для одностраничного приложения) для веб-сайта или собственного приложения; для приложения для телевизора или устройства, вход в код в командной строке и в Node.
- Для SAML-приложения вместо идентификатора клиента и кода: адрес метаданных и другие сведения, которые должны быть предоставлены приложению, а также его сертификат подписи.
Секрет клиента
Секрет - это пароль приложения, и он показан только сейчас. Скопируйте его в приложение или загрузите файл .env перед закрытием окна, а затем отметьте Я сохранил секрет. Если он потерян, используйте Вращать Секрет на карте приложения, чтобы создать новую. Одностраничные приложения и мобильные приложения не имеют секрета.
Файл .env
Загрузить .env файл сохраняет небольшой текстовый файл со всеми значениями, необходимыми приложению (адрес входа, адрес обнаружения, идентификатор клиента, секрет, обратный адрес и разрешения) в формате, который читает большинство фреймворков. Держите его вне контроля исходного кода: в нем содержится секрет.
Образцы кода
Работающий код входа для веб-сайта или приложения собственного. Каждый пример читает .env файл, так что один и тот же файл работает со всеми ими. Они используют хорошо известные библиотеки с открытым исходным кодом: openid-client для Node, Authlib для Python, и OpenID Connect PHP для PHP.
Похожие статьи
Другие руководства, которые отвечают на вопросы, близкие к этому.
Создание приложения на входе вашей организации
Эта страница предназначена для разработчиков. Вход в систему вашей организации является стандартным OAuth 2.0 и OpenID Connect поставщика, так что любое приложение или инструмент может войти ваши люди с их Kamo учетных…
Подключенные приложения
Подключенные приложения позволяют вашим пользователям войти на другие сайты и приложения, такие как WordPress, Grafana, Moodle, Nextcloud или ваш собственный сайт, с помощью учетной записи Kamo, которой они уже обладают…
Удостоверение личности и вход
Ваша организация имеет свою страницу входа в систему по адресу вход. за которым следует ваш домен. Эта страница определяет, что предлагает страница входа: какие способы входа, какие учетные записи люди могут принести с…
Использование организации в качестве поставщика удостоверений SAML
Некоторые из приложений ваша команда использует — вики, справочные бюро, обучающие платформы, панели управления — люди входят с Единый вход SAML вместо OpenID Connect. Kamo может быть поставщиком идентификации для них.…
Разрешить приложениям самостоятельно подключаться
Некоторые приложения, например AI ассистенты, использующие MCP и средства командной строки, могут самостоятельно подключаться к системе входа в организацию вместо того, чтобы администратор вводил их. Это называется…
Приложения с доступом
Ваша организация может разрешить вам войти в другие веб-сайты и приложения с помощью учетной записи организации, например в корпоративный блог, на информационные панели или на учебный сайт. При первом входе в систему…
Войти на телевизоре или устройстве
Некоторые приложения работают на экранах, где ввод пароля неприятен — телевизор в холле, дисплей в зале заседаний, принтер, игровая консоль или инструмент командной строки. Вместо того, чтобы спрашивать о вашем пароле,…
