OfficeRuntime.AuthOptions interface

Paquete:

office-runtime

Proporciona opciones para la experiencia del usuario cuando Office obtiene un token de acceso al complemento desde AAD v. 2.0 con el getAccessToken método .

Comentarios

Los métodos de esta interfaz son equivalentes a los de la Office.AuthOptions interfaz. Si se agregan nuevos tipos de autenticación en el futuro, solo se agregarán a la Office.AuthOptions interfaz. Por motivos de simplicidad, los ejemplos de código de toda la documentación usan Office.AuthOptions.

Propiedades

allowConsentPrompt	Permite a Office obtener un token de acceso de forma silenciosa o mediante consentimiento interactivo, si se requiere uno. El valor predeterminado es false. Si se establece en false, Office intentará obtener un token de acceso de forma silenciosa. Si no lo hace, Office devolverá un error descriptivo. Si se establece en true, Office mostrará una interfaz de usuario de consentimiento interactiva después de que no obtenga un token de acceso de forma silenciosa. El símbolo del sistema solo permitirá el consentimiento al ámbito del perfil de AAD, no a ningún ámbito de Microsoft Graph.
allowSignInPrompt	Permite a Office obtener un token de acceso si el consentimiento está presente de forma silenciosa o mostrar la interfaz de usuario interactiva para iniciar sesión en el usuario. El valor predeterminado es false. Si se establece en false, Office intentará obtener un token de acceso de forma silenciosa. Si no lo hace, Office devolverá un error descriptivo. Si se establece trueen , Office mostrará una interfaz de usuario de inicio de sesión interactivo después de que no obtenga un token de acceso de forma silenciosa.
asyncContext	Elemento definido por el AsyncResult usuario de cualquier tipo que se devuelve, sin cambios, en la asyncContext propiedad del objeto que se pasa a una devolución de llamada.
authChallenge	Hace que Office pida al usuario que proporcione el factor adicional cuando el inquilino al que se dirige Microsoft Graph requiere autenticación multifactor. El valor de cadena identifica el tipo de factor adicional necesario. En la mayoría de los casos, no sabrá en tiempo de desarrollo si el inquilino del usuario requiere un factor adicional o cuál debe ser la cadena. Por lo tanto, esta opción se usaría en una llamada de "segundo intento" de después de getAccessToken que Microsoft Graph haya enviado un error solicitando el factor adicional y que contenga la cadena que se debe usar con la authChallenge opción .
forceAddAccount	Solicita al usuario que agregue su cuenta de Office (o que cambie a ella, si ya se ha agregado). El valor predeterminado es false.
forceConsent	Hace que Office muestre la experiencia de consentimiento del complemento. Es útil si los permisos de Azure del complemento han cambiado o si se ha revocado el consentimiento del usuario. El valor predeterminado es false.
forMSGraphAccess	Hace que Office devuelva un error descriptivo cuando el complemento quiera acceder a Microsoft Graph y el usuario o administrador no haya concedido consentimiento a los ámbitos de Graph. El valor predeterminado es false. Office solo admite el consentimiento a los ámbitos de Graph cuando un administrador de inquilinos ha implementado el complemento. Si se establece esta opción true en , Office informará de antemano al complemento (devolviendo un error descriptivo) si se producirá un error en el acceso a Graph.

Detalles de las propiedades

allowConsentPrompt

Permite a Office obtener un token de acceso de forma silenciosa o mediante consentimiento interactivo, si se requiere uno. El valor predeterminado es false. Si se establece en false, Office intentará obtener un token de acceso de forma silenciosa. Si no lo hace, Office devolverá un error descriptivo. Si se establece en true, Office mostrará una interfaz de usuario de consentimiento interactiva después de que no obtenga un token de acceso de forma silenciosa. El símbolo del sistema solo permitirá el consentimiento al ámbito del perfil de AAD, no a ningún ámbito de Microsoft Graph.

allowConsentPrompt?: boolean;

Valor de propiedad

boolean

allowSignInPrompt

Permite a Office obtener un token de acceso si el consentimiento está presente de forma silenciosa o mostrar la interfaz de usuario interactiva para iniciar sesión en el usuario. El valor predeterminado es false. Si se establece en false, Office intentará obtener un token de acceso de forma silenciosa. Si no lo hace, Office devolverá un error descriptivo. Si se establece trueen , Office mostrará una interfaz de usuario de inicio de sesión interactivo después de que no obtenga un token de acceso de forma silenciosa.

allowSignInPrompt?: boolean;

Valor de propiedad

boolean

asyncContext

Elemento definido por el AsyncResult usuario de cualquier tipo que se devuelve, sin cambios, en la asyncContext propiedad del objeto que se pasa a una devolución de llamada.

asyncContext?: any;

Valor de propiedad

any

authChallenge

Hace que Office pida al usuario que proporcione el factor adicional cuando el inquilino al que se dirige Microsoft Graph requiere autenticación multifactor. El valor de cadena identifica el tipo de factor adicional necesario. En la mayoría de los casos, no sabrá en tiempo de desarrollo si el inquilino del usuario requiere un factor adicional o cuál debe ser la cadena. Por lo tanto, esta opción se usaría en una llamada de "segundo intento" de después de getAccessToken que Microsoft Graph haya enviado un error solicitando el factor adicional y que contenga la cadena que se debe usar con la authChallenge opción .

authChallenge?: string;

Valor de propiedad

string

forceAddAccount

Advertencia

Esta API ya está en desuso.

Use allowSignInPrompt instead.

Solicita al usuario que agregue su cuenta de Office (o que cambie a ella, si ya se ha agregado). El valor predeterminado es false.

forceAddAccount?: boolean;

Valor de propiedad

boolean

forceConsent

Advertencia

Esta API ya está en desuso.

Use allowConsentPrompt instead.

Hace que Office muestre la experiencia de consentimiento del complemento. Es útil si los permisos de Azure del complemento han cambiado o si se ha revocado el consentimiento del usuario. El valor predeterminado es false.

forceConsent?: boolean;

Valor de propiedad

boolean

forMSGraphAccess

Hace que Office devuelva un error descriptivo cuando el complemento quiera acceder a Microsoft Graph y el usuario o administrador no haya concedido consentimiento a los ámbitos de Graph. El valor predeterminado es false. Office solo admite el consentimiento a los ámbitos de Graph cuando un administrador de inquilinos ha implementado el complemento. Si se establece esta opción true en , Office informará de antemano al complemento (devolviendo un error descriptivo) si se producirá un error en el acceso a Graph.

forMSGraphAccess?: boolean;

Valor de propiedad

boolean

Comentarios

Nota: Si va a desarrollar un complemento de Outlook que usa el inicio de sesión único (SSO), anótese la forMSGraphAccess opción antes de transferir localmente el complemento para realizar pruebas. De lo contrario, recibirá el error 13012. Para obtener instrucciones adicionales, consulte Detalles sobre el inicio de sesión único con un complemento de Outlook.