Eseguire l'autenticazione con Microsoft Web IQ

Esistono due modi per eseguire l'autenticazione con le API di runtime di Microsoft Web IQ. Usare una chiave API per iniziare più rapidamente e Microsoft Entra ID per i carichi di lavoro di produzione.

API key

Creare una chiave API nel portale Microsoft Web IQ per l'autenticazione con le API Microsoft Web IQ. Passarlo nell'intestazione x-apikey per ogni richiesta:

x-apikey: <YOUR_API_KEY>

Microsoft Entra ID

Usare Microsoft Entra ID credenziali client OAuth 2.0 (token solo app) per l'autenticazione con l'API IQ Web Microsoft.

Prerequisites

1. Configurare un tenant: Per registrare l'app, è necessario un tenant Azure. Non è necessaria una sottoscrizione Azure, ma se l'organizzazione ha già una o più sottoscrizioni Azure o un'organizzazione Microsoft 365, allora dispone già di un tenant Azure. In caso contrario, effettuare il provisioning di un nuovo tenant.

2. Creare una registrazione dell'app: Una registrazione dell'app stabilisce una relazione di trust tra l'applicazione e il Microsoft Identity Platform, consentendo all'app di autenticare e accedere in modo sicuro alle risorse.

   Quando si registra l'app, vengono creati un ID client, un ID oggetto e un ID directory. Per creare le credenziali per la registrazione dell'app, vedere Registrare un'applicazione con il Microsoft Identity Platform.

Entra ID procedura di configurazione

1. Registrazione dell'app: usare una registrazione dell'app Microsoft Entra ID esistente o crearne una. Annotare l'ID applicazione (client). Nel portale di Azure trovarlo in Microsoft Entra ID>Registrazioni app>la tua app>Panoramica.

2. Associare la registrazione dell'app : passare a Gestione profili, selezionare la scheda ID applicazione (client) e quindi selezionare Associa ID applicazione (client). Immetti l'ID client dell'applicazione Entra. La sincronizzazione degli aggiornamenti dei profili può richiedere fino a un minuto.

   Note

   Se la scheda ID applicazione (client) non è disponibile, l'autenticazione di Microsoft Entra ID potrebbe non essere abilitata per la versione di valutazione. Contattare il rappresentante Microsoft per richiedere l'accesso dedicato.

3. Acquisisci un token - usare la concessione delle credenziali client con il Libreria di Autenticazione Microsoft preferito (MSAL):

   • Autorità: https://login.microsoftonline.com/{your-tenant-id}
   • Ambito: https://api.microsoft.ai/.default

Passare quindi il token di accesso a ogni richiesta Web IQ:

Authorization: Bearer <access-token>

Chiamata di più AppID

Un ID applicazione Entra (client) può essere associato a più di un ID app IQ Web, ad esempio un ID app per ogni risorsa IQ Web o per ogni carico di lavoro. In questo caso, aggiungere il APPID parametro di query a ogni richiesta per scegliere l'ID app usato dalla chiamata. I limiti di frequenza vengono conteggiati per quell'AppID.

POST https://api.microsoft.ai/v3/search/web?APPID=<your-web-iq-appid>
Authorization: Bearer <access-token>
Content-Type: application/json

APPID accetta Web IQ AppID, non l'ID applicazione Entra (client). Il contatto Microsoft fornisce i tuoi AppID di Web IQ.

Intestazioni della richiesta

Passaggi successivi

• Effettuare la prima chiamata nella guida introduttiva.
• Esplora la documentazione di riferimento dell'API REST.

Supporto e feedback

Inviare problemi tecnici o commenti al Web IQ Support.