Provedor de proxy

Quando utiliza o fornecedor de proxy, pode utilizar a autenticação de back-end (como o fluxo Auth2.0 On-Behalf-Of) para ligar o Microsoft Graph Toolkit ao encaminhar todas as chamadas para o Microsoft Graph através do seu próprio back-end.

O serviço de back-end tem de expor uma API que é chamada para cada chamada ao Microsoft Graph. Por exemplo, quando um componente tenta obter um recurso, o ProxyProvider chama a API base e acrescenta esse recurso.

https://graph.microsoft.com/v1.0/me => https://myurl.com/api/GraphProxy/v1.0/me

Em seguida, a implementação da API deve chamar o Microsoft Graph em nome do utilizador e devolver os resultados ao componente.

Para obter um exemplo de implementação, veja o exemplo ASP.NET MVC.

Para saber mais sobre os fornecedores de autenticação, veja fornecedores.

Introdução

Pode inicializar o fornecedor de proxy em HTML ou JavaScript. Deve fazê-lo apenas uma vez por página.

Inicializar na sua página HTML

Inicializar o fornecedor de proxy em HTML é a forma mais simples de definir a sua própria rota para a autenticação personalizada do lado do servidor. Utilize o mgt-proxy-provider componente para definir o graph-proxy-url. Define o fornecedor de proxy definido como o fornecedor global.

<mgt-proxy-provider
  graph-proxy-url="https://myurl.com/api/GraphProxy"
></mgt-proxy-provider>

Inicializar em JavaScript

Pode fornecer mais opções ao inicializar o fornecedor em JavaScript.

import { Providers } from "@microsoft/mgt-element";
import { ProxyProvider } from "@microsoft/mgt-proxy-provider";

Providers.globalProvider = new ProxyProvider(
  "https://myurl.com/api/GraphProxy"
);

Opcionalmente, pode enviar cabeçalhos adicionais com cada pedido para a sua api de proxy através de uma função opcional como segundo parâmetro no construtor.

import { Providers } from "@microsoft/mgt-element";
import { ProxyProvider } from "@microsoft/mgt-proxy-provider";

Providers.globalProvider = new ProxyProvider(
  "https://myurl.com/api/GraphProxy",
  async () => {
    return {
      header: "value",
      header2: "value2",
    };
  }
);

É útil quando precisa de passar tokens ou outros cabeçalhos para o back-end.

Se estiver a utilizar o mgt-login componente, também deve especificar as login funções e logout para o fornecedor:

import { Providers } from "@microsoft/mgt-element";
import { ProxyProvider } from "@microsoft/mgt-proxy-provider";

let provider = new ProxyProvider("https://myurl.com/api/GraphProxy");
provider.login = () => {
  /* will be called when "Sign In" is clicked */
};
provider.logout = () => {
  /* will be called when "Sign Out" is called */
};

Providers.globalProvider = provider;