Office.AuthOptions interface
Предоставляет параметры для взаимодействия с пользователем, когда Office получает маркер доступа к надстройке из AAD версии 2.0 с getAccessToken помощью метода .
Свойства
| allow |
Позволяет Office получать маркер доступа автоматически или с помощью интерактивного согласия, если оно требуется. Значение по умолчанию — |
| allow |
Позволяет Office получать маркер доступа автоматически при условии предоставления согласия или отображать интерактивный пользовательский интерфейс для входа пользователя. Значение по умолчанию — |
| async |
Определяемый пользователем элемент любого типа, который возвращается без изменений в |
| auth |
Заставляет Office запрашивать у пользователя дополнительный фактор, если арендатору, на который ориентируется Microsoft Graph, требуется многофакторная проверка подлинности. Строковое значение определяет тип дополнительного фактора, который требуется. В большинстве случаев во время разработки вы не узнаете, требуется ли клиенту пользователя дополнительный фактор или какая строка должна быть. Таким образом, этот параметр будет использоваться в вызове |
| force |
Запросы пользователю добавить свою учетную запись Office (или переключиться на нее, если она уже добавлена). Значение по умолчанию — |
| force |
Сообщает Office, что нужно показать интерфейс согласия для надстройки. Это полезно, если разрешения Azure изменились или согласие пользователя было отозвано. Значение по умолчанию — |
| for |
Заставляет Office возвращать описательную ошибку, если надстройка хочет получить доступ к Microsoft Graph, а пользователь или администратор не предоставил согласие на области Graph. Значение по умолчанию — |
Подробнее
allowConsentPrompt
Позволяет Office получать маркер доступа автоматически или с помощью интерактивного согласия, если оно требуется. Значение по умолчанию — false. Если задано значение false, Office автоматически попытается получить маркер доступа. Если это не удается сделать, Office вернет описательную ошибку. Если задано значение true, Office будет отображать интерактивный пользовательский интерфейс согласия после того, как не удается автоматически получить маркер доступа. Запрос разрешает согласие только для область профиля AAD, но не для областей Microsoft Graph.
allowConsentPrompt?: boolean;Стоимость недвижимости
boolean
allowSignInPrompt
Позволяет Office получать маркер доступа автоматически при условии предоставления согласия или отображать интерактивный пользовательский интерфейс для входа пользователя. Значение по умолчанию — false. Если задано значение false, Office автоматически попытается получить маркер доступа. Если это не удается сделать, Office вернет описательную ошибку. Если задано значение true, office будет отображать интерактивный пользовательский интерфейс входа после того, как не удается автоматически получить маркер доступа.
allowSignInPrompt?: boolean;Стоимость недвижимости
boolean
asyncContext
Определяемый пользователем элемент любого типа, который возвращается без изменений в asyncContext свойстве AsyncResult объекта, передаваемого обратному вызову.
asyncContext?: any;Стоимость недвижимости
any
authChallenge
Заставляет Office запрашивать у пользователя дополнительный фактор, если арендатору, на который ориентируется Microsoft Graph, требуется многофакторная проверка подлинности. Строковое значение определяет тип дополнительного фактора, который требуется. В большинстве случаев во время разработки вы не узнаете, требуется ли клиенту пользователя дополнительный фактор или какая строка должна быть. Таким образом, этот параметр будет использоваться в вызове getAccessToken "second try" после того, как Microsoft Graph отправил ошибку с запросом дополнительного коэффициента и содержит строку, которую следует использовать с параметром authChallenge .
authChallenge?: string;Стоимость недвижимости
string
forceAddAccount
Предупреждение
Этот API теперь устарел.
Use allowSignInPrompt instead.
Запросы пользователю добавить свою учетную запись Office (или переключиться на нее, если она уже добавлена). Значение по умолчанию — false.
forceAddAccount?: boolean;Стоимость недвижимости
boolean
forceConsent
Предупреждение
Этот API теперь устарел.
Use allowConsentPrompt instead.
Сообщает Office, что нужно показать интерфейс согласия для надстройки. Это полезно, если разрешения Azure изменились или согласие пользователя было отозвано. Значение по умолчанию — false.
forceConsent?: boolean;Стоимость недвижимости
boolean
forMSGraphAccess
Заставляет Office возвращать описательную ошибку, если надстройка хочет получить доступ к Microsoft Graph, а пользователь или администратор не предоставил согласие на области Graph. Значение по умолчанию — false. Office поддерживает согласие только для областей Graph, когда надстройка развернута администратором клиента. Если для этого параметра задано значение , true Office заранее сообщит надстройке (возвращая описательную ошибку), если доступ к Graph завершится ошибкой.
forMSGraphAccess?: boolean;Стоимость недвижимости
boolean
Замечания
Примечание. Если вы разрабатываете надстройку Outlook, которая использует единый вход ( SSO), закомментируйте forMSGraphAccess параметр перед загрузкой неопубликованного надстройки для тестирования. В противном случае появится сообщение об ошибке 13012. Дополнительные рекомендации см. в статье Сведения об едином входе в надстройке Outlook.