К тексту на этой странице мог быть частично применён машинный перевод.

Утверждение SAML: примеры запросов, поддерживаемых Smartsheet

В этой статье приведены примеры поддерживаемых запросов и утверждений SAML.

Доступно для:

Планы:

  • Smartsheet
  • Enterprise

Необходимые атрибуты

Для успешной проверки подлинности при входе в Smartsheet нужно передать запросы постоянного идентификатора и адреса электронной почты. This requires two separate claims. 

Find additional details below. 

Постоянный идентификатор

Постоянный идентификатор​ можно определить как атрибут удостоверения, вероятность изменения которого минимальна. Smartsheet поддерживает шесть форматов значений, кодируемых в элементе NameID (некоторые из них не описаны в стандарте SAML 2.0). Все поддерживаемые варианты приведены ниже.

  • urn:oasis:names:tc:SAML:1.1:nameid-­format:emailAddress
  • urn:oasis:names:tc:SAML:2.0:nameid­-format:email
  • urn:oasis:names:tc:SAML:2.0:nameid-­format:persistent
  • urn:oasis:names:tc:SAML:2.0:nameid-­format:unspecified
  • urn:oasis:names:tc:SAML:1.1:nameid­-format:unspecified
  • urn:oid:1.3.6.1.4.1.5923.1.1.1.10 

Smartsheet также принимает утверждения без элемента NameID и извлекает значение постоянного идентификатора из атрибутов, если среди них есть атрибут в следующем формате: 

  • name="eduPersonPrincipalName" nameFormat="urn:oasis:names:tc:SAML:2.0:attrname-­format:basic"
  • name="http://schemas.microsoft.com/ws/2008/06/identity/claims/windowsaccountname"
  • name="persistent" nameFormat="urn:oasis:names:tc:SAML:2.0:nameid-­format:persistent"
  • name="urn:oid:1.3.6.1.4.1.5923.1.1.1.6" nameFormat="urn:oasis:names:tc:SAML:2.0:attrname-­format:uri"
  • name="eduPersonPrincipalName" nameFormat="urn:oasis:names:tc:SAML:2.0:attrname-­format:uri"

Адрес электронной почты

Атрибут Адрес электронной почты — это адрес электронной почты, связанный с учётной записью Smartsheet. В Smartsheet он используется в качестве имени пользователя. Этот атрибут не извлекается из элемента NameID. 

Ниже приведены поддерживаемые форматы. 

  • name="email" name="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"
  • name="emailAddress",nameFormat="urn:oasis:names:tc:SAML:2.0:attrname-­format:basic"
  • name="Email",nameFormat="urn:oasis:names:tc:SAML:2.0:attrname­-format:basic"
  • name="saml_username",nameFormat="urn:oasis:names:tc:SAML:2.0:attrname-­format:basic"
  • name="emailaddress",nameFormat="urn:oasis:names:tc:SAML:2.0:attrname-­format:unspecified"
  • name="emailaddress",nameFormat="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"
  • name="urn:oid:0.9.2342.19200300.100.1.3",nameFormat="urn:oasis:names:tc:SAML:2.0:attrname-­format:uri"
  • name="mail",nameFormat="urn:oasis:names:tc:SAML:2.0:attrname­-format:basic" 

Необязательные атрибуты 

Имя

Атрибут Имя — это личное имя пользователя, связанного с данной учётной записью (например, Евгений или Анна). 

These are the supported formats: 

  • name="givenName" name="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname"
  • name="givenname" nameFormat="urn:oasis:names:tc:SAML:2.0:attrname-­format:basic"
  • name="given_name" nameFormat="urn:oasis:names:tc:SAML:2.0:attrname-­format:basic"
  • name="givenname" nameFormat="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname"
  • name="givenname" nameFormat="urn:oasis:names:tc:SAML:2.0:attrname­-format:unspecified"
  • name="urn:oid:2.5.4.42" nameFormat="urn:oasis:names:tc:SAML:2.0:attrname-­format:uri"

Фамилия

Атрибут Фамилия — это фамилия пользователя, связанного с данной учётной записью. 

These are the supported formats:

  • name="surname" 
  • name="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname"
  • name="surname" nameFormat="urn:oasis:names:tc:SAML:2.0:attrname­-format:basic"
  • name="sur_name" nameFormat="urn:oasis:names:tc:SAML:2.0:attrname-­format:basic"
  • name="surname" nameFormat="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname"
  • name="surname" nameFormat="urn:oasis:names:tc:SAML:2.0:attrname­-format:unspecified"
  • name="urn:oid:2.5.4.4" nameFormat="urn:oasis:names:tc:SAML:2.0:attrname­-format:uri"

Пример утверждения 

При генерировании метаданных используйте приведённые выше запросы.

Просмотреть примеры ответных утверждений SAML можно по следующей ссылке:
https://www.samltool.com/generic_sso_res.php

 

ПРИМЕЧАНИЕ. Эти примеры приведены исключительно для наглядности и не работают в Smartsheet. Метаданные для вас должен сгенерировать поставщик удостоверений (IdP).