Delen via

Een aangepaste domeinnaam configureren voor een zelf-hostende gateway

VAN TOEPASSING OP: Ontwikkelaar | Premie

Wanneer u een zelf-hostende Azure API Management-gateway inricht, wordt deze geen hostnaam toegewezen en moet er naar worden verwezen door het IP-adres. In dit artikel wordt beschreven hoe u een bestaande aangepaste DNS-naam (ook wel hostnaam genoemd) toe te wijzen aan een zelf-hostende gateway.

Vereiste voorwaarden

Als u de stappen wilt uitvoeren die in dit artikel worden beschreven, moet u het volgende hebben:

  • Een actief Azure-abonnement.

    Als u geen Azure-account hebt, maak dan een gratis account aan voordat u begint.

  • Een API Management-exemplaar. Zie Een Azure API Management-exemplaar maken voor meer informatie.

  • Een zelf-gehoste gateway. Zie Hoe u de zelf-gehoste gateway configureert voor meer informatie.

  • Een aangepaste domeinnaam die eigendom is van u of uw organisatie. Dit onderwerp bevat geen instructies voor het aanschaffen van een aangepaste domeinnaam.

  • Een DNS-record die wordt gehost op een DNS-server die de aangepaste domeinnaam toe wijst aan het IP-adres van de zelf-hostende gateway. Dit onderwerp bevat geen instructies voor het hosten van een DNS-record.

  • U moet een geldig certificaat hebben met een openbare en persoonlijke sleutel (. PFX). Het onderwerp of de alternatieve naam van het onderwerp (SAN) moet overeenkomen met de domeinnaam (hierdoor kan het API Management-exemplaar veilig URL's beschikbaar maken via TLS).

Ga naar uw API Management-instantie

  1. Zoek en selecteer in de Azure portalde API Management-services:

    Schermopname van API Management-services in de zoekresultaten.

  2. Selecteer op de pagina API Management-services uw API Management-exemplaar:

    Schermopname van een API Management-exemplaar op de pagina API Management-services.

Aangepast domeincertificaat toevoegen aan uw API Management-service

Een aangepast domeincertificaat toevoegen (. PFX)-bestand naar uw API Management-exemplaar of verwijzen naar een certificaat dat is opgeslagen in Azure Key Vault. Volg de stappen in Back-endservices beveiligen met behulp van clientcertificaatverificatie in Azure API Management.

Notitie

U wordt aangeraden een sleutelkluiscertificaat te gebruiken voor het zelf-hostende gatewaydomein.

Azure Portal gebruiken om een aangepaste domeinnaam in te stellen voor uw zelf-hostende gateway

  1. Selecteer de Gateways vanuit Implementatie en infrastructuur.
  2. Selecteer de zelf-hostende gateway waarvoor u de domeinnaam wilt configureren.
  3. Selecteer Hostnamen onder Instellingen.
  4. Selecteer + Toevoegen
  5. Voer de resourcenaam voor de hostnaam in het veld Naam in.
  6. Voer de domeinnaam in het veld Hostnaam in.
  7. Selecteer een certificaat in de vervolgkeuzelijst Certificaat .
  8. Schakel het selectievakje Negotiate clientcertificaat in als een van de API's die via deze gateway worden aangeboden, clientcertificaatverificatie gebruikt.

    Waarschuwing

    Deze instelling wordt gedeeld door alle domeinnamen die zijn geconfigureerd voor de gateway.

  9. Selecteer Toevoegen om de aangepaste domeinnaam toe te wijzen aan de geselecteerde zelf-hostende gateway.

Notitie

Als clients die verbinding maken met de zelf-hostende gateway met behulp van het aangepaste domein, alle tussenliggende certificaten in de keten moeten weergeven, moet u afzonderlijke CA-certificaten uploaden naar uw API Management-service en deze koppelen aan de zelf-hostende gateway. Zie Aangepaste CA maken voor zelfgehoste gateway voor instructies over hoe u dit doet.

Verwante inhoud

Uw service upgraden en schalen