Эндпоинт SP-метаданных
SecureCodingHub публикует реальный документ метаданных Поставщика услуг SAML 2.0 по стабильному URL, чтобы поставщики идентификации могли настраиваться через импорт метаданных, а не вводом значений вручную.
Эндпоинт
Получите метаданные через HTTPS:
GET https://api.limeplate.com/api/sch/auth/sso/metadataОтвет — документ Content-Type application/samlmetadata+xml, содержащий единственный <EntityDescriptor>. Документ стабилен — тот же EntityID, тот же ACS URL, тот же формат NameID. Безопасно импортировать URL напрямую в Ваш IdP и позволить IdP обновлять его по своей обычной каденции.
Что внутри документа
| Элемент | Значение |
|---|---|
| EntityID | Service Provider Entity ID для SecureCodingHub. Это то, что Ваш IdP использует для идентификации SP. |
| AssertionConsumerService binding | urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST |
| NameIDFormat | urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress |
| AuthnRequestsSigned | false |
| WantAssertionsSigned | true |
URL-эндпоинты на стороне IdP, закодированные внутри метаданных, выведены из настроенного бэкенд-URL развёртывания, поэтому документ, который Вы получаете в продакшене, указывает на продакшен-callback-путь. Нет ручного шаблонирования; файл генерируется при каждом запросе.
Как его использовать
В конфигурации SAML Вашего поставщика идентификации поищите поле URL метаданных или Импорт из URL. Вставьте URL-эндпоинт выше и позвольте IdP получить документ. IdP заполнит Entity ID, ACS, формат NameID и требование подписи утверждений напрямую из документа, что надёжнее, чем ввод значений вручную.
Некоторые IdP принимают только загруженные файлы. В этом случае получите URL с помощью curl и загрузите результирующий XML:
curl -o sch-sp-metadata.xml https://api.limeplate.com/api/sch/auth/sso/metadataКогда документ меняется
Документ генерируется из живой конфигурации SecureCodingHub при каждом запросе. Самая распространённая причина, по которой он мог бы измениться, — это обновление на уровне развёртывания бэкенд-хостнейма или ACS callback-пути. Если Ваш IdP импортирует метаданные по URL, он подхватит изменение автоматически при следующем обновлении; если Вы импортировали документ как файл, Вам нужно будет повторно загрузить его. Подпишитесь на security@securecodinghub.com для редких случаев, когда изменение такого рода объявляется заранее.