Referenties voor toegang tot Media Services-API ophalen

API-toegang

Op de pagina API-toegang kunt u de verificatie methode selecteren die u wilt gebruiken om verbinding te maken met de API. De pagina bevat ook de waarden die u nodig hebt om verbinding te maken met de API.

1. Selecteer uw Media Services account in de Azure Portal.
2. Selecteer de Blade API-toegang op de linkernavigatiebalk.
3. Selecteer onder verbinding maken met Media Services-API de versie van de Media Services-API waarmee u verbinding wilt maken (v3 is de nieuwste versie van de service).

Service-Principal-verificatie (aanbevolen)

Verifieert een service met een Azure Active Directory-app (Azure AD) en een geheim. Dit wordt aanbevolen voor alle services in de middelste laag die de Media Services-API aanroepen. Voor beelden zijn Web Apps, functions, Logic Apps, Api's en micro Services. Dit is de aanbevolen verificatie methode.

Uw Azure AD-app en-geheim beheren

Met de sectie uw Aad-app beheren en geheime kunt u een nieuwe Azure AD-app selecteren of maken en een geheim genereren. Uit veiligheids overwegingen kan het geheim niet worden weer gegeven nadat de Blade is gesloten. De toepassing maakt gebruik van de toepassings-ID en het geheim voor verificatie om een geldig token voor Media Services te verkrijgen.

Zorg ervoor dat u voldoende machtigingen hebt om een toepassing te registreren bij uw Azure AD-Tenant en de toepassing toe te wijzen aan een rol in uw Azure-abonnement. Zie vereiste machtigingenvoor meer informatie.

Verbinding maken met de Media Services-API

De API Connect to Media Services biedt u waarden die u gebruikt om verbinding te maken met uw Service Principal-toepassing. U kunt tekst waarden ophalen of de JSON-of XML-blokken kopiëren.

Gebruikersverificatie

Deze optie kan worden gebruikt voor het verifiëren van een werk nemer of lid van een Azure Active Directory die een app gebruikt om te communiceren met Media Services resources. De interactieve toepassing moet eerst de gebruiker vragen naar de referenties van de gebruiker. Deze verificatie methode mag alleen worden gebruikt voor beheer toepassingen.

Verbinding maken met de Media Services-API

Kopieer uw referenties om uw gebruikers toepassing te verbinden via de sectie verbinding maken met Media Services-API . U kunt tekst waarden ophalen of de JSON-of XML-blokken kopiëren.

Toegang kunt krijgen tot de Media Services API

Om verbinding te maken met Azure Media Services API's, gebruikt u de service-principal-verificatie van Azure Active Directory. Met de volgende opdracht wordt een Azure AD-toepassing gemaakt en een service-principal aan de account gekoppeld. De geretourneerde waarden moet u gebruiken om uw toepassing te configureren.

Voordat u het script uitvoert, moet u de amsaccount en vervangen door amsResourceGroup de namen die u hebt gekozen bij het maken van deze resources. amsaccount is de naam van de Azure Media Services-account waaraan de service-principal moet worden gekoppeld.

Als u toegang hebt tot meerdere abonnementen, stelt u eerst het actieve abonnement in op het abonnement waar het Media Services-account is gemaakt.

az account set --subscription subscriptionId

De volgende opdracht retourneert een json-uitvoer:

az ams account sp create --account-name amsaccount --resource-group amsResourceGroup

Met deze opdracht wordt een respons geproduceerd die vergelijkbaar is met de volgende:

{
  "AadClientId": "00000000-0000-0000-0000-000000000000",
  "AadEndpoint": "https://login.microsoftonline.com",
  "AadSecret": "00000000-0000-0000-0000-000000000000",
  "AadTenantId": "00000000-0000-0000-0000-000000000000",
  "AccountName": "amsaccount",
  "ArmAadAudience": "https://management.core.windows.net/",
  "ArmEndpoint": "https://management.azure.com/",
  "Region": "West US 2",
  "ResourceGroup": "amsResourceGroup",
  "SubscriptionId": "00000000-0000-0000-0000-000000000000"
}

Als u een xml in het antwoord wilt hebben, gebruikt u de volgende opdracht:

az ams account sp create --account-name amsaccount --resource-group amsResourceGroup --xml