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

Используйте эту статью как справочник с примерами поддерживаемых запросов и утверждений SAML.

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

Для успешной проверки подлинности при входе в Smartsheet нужно передать запросы постоянного идентификатора и адреса электронной почты. Для этого требуется два отдельных запроса (подробную информацию см. ниже).

Постоянный идентификатор — его можно определить как атрибут удостоверения, вероятность изменения которого минимальна. 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" 

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

Имя — имя пользователя, связанного с данной учётной записью. Ниже приведены поддерживаемые форматы.

  • 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"

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

  • 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. Метаданные для вас должен сгенерировать поставщик удостоверений.