Toegangssleutels van Fluid Relay Server roteren

Dit artikel bevat een overzicht van het beheren van toegangssleutels (tenantsleutels) in Azure Fluid Relay Service. Microsoft raadt u aan uw sleutels regelmatig te roteren voor betere beveiliging.

Primaire/secundaire sleutels

Klanten gebruiken de toegangssleutels om de toegangstokens te ondertekenen die worden gebruikt voor toegang tot Azure Fluid Relay Services. Azure Fluid Relay gebruikt de sleutels om de tokens te valideren.

Er zijn twee sleutels gekoppeld aan elke Azure Fluid Relay-service: een primaire sleutel en een secundaire sleutel. Het doel van dubbele sleutels is om u sleutels opnieuw te laten genereren of te rollen, zodat u continue toegang krijgt tot uw account en gegevens.

Uw toegangssleutels weergeven

Azure-portal

Als u uw toegangssleutels wilt zien, zoekt u in Azure Portal naar uw Azure Fluid Relay-service. Selecteer Instellingen in het linkermenu van de Azure Fluid Relay Service-pagina. Selecteer vervolgens Toegangssleutels. Selecteer de knop Kopiëren om de geselecteerde sleutel te kopiëren.

PowerShell

Als u uw toegangssleutels wilt ophalen met PowerShell, moet u eerst de Azure Fluid Relay-module installeren.

Install-Module Az.FluidRelay

Roep vervolgens de opdracht Get-AzFluidRelayServerKey aan.

Get-AzFluidRelayServerKey -FluidRelayServerName <Fluid Relay Service name> -ResourceGroup <resource group> -SubscriptionId <subscription id>

Azure-CLI

Als u uw toegangssleutels wilt ophalen met Azure CLI, moet u eerst de fluid-relay-extensie installeren. Zie Instructies.

Gebruik vervolgens az fluid-relay server list-key command om toegangssleutels weer te geven.

az fluid-relay server list-key --resource-group <resource group> --server-name <Fluid Relay Service name>

Uw toegangssleutels draaien

Er worden twee toegangssleutels toegewezen, zodat uw Azure Fluid Relay-service niet offline hoeft te worden gehaald wanneer u een sleutel roteert. Als u twee sleutels hebt, zorgt u ervoor dat uw toepassing gedurende het hele proces toegang tot Azure Fluid Relay behoudt. U moet een van de twee sleutels tegelijk draaien om serviceonderbrekingen te voorkomen.

Het proces van het draaien van primaire en secundaire sleutels is hetzelfde. De volgende stappen zijn bedoeld voor primaire sleutels.

Azure-portal

De primaire sleutel van Azure Fluid Relay roteren in Azure Portal:

1. Werk de toegangssleutels in uw toepassingscode bij om de secundaire toegangssleutel voor Azure Fluid Relay te gebruiken.

2. Navigeer naar uw Fluid Relay-service in Azure Portal.

3. Selecteer Onder Instellingen de optie Toegangssleutel.

4. Als u de primaire toegangssleutel voor uw Azure Fluid Relay-service opnieuw wilt genereren, selecteert u de knop Primaire sleutel opnieuw genereren boven de toegangsgegevens.

5. Werk de primaire sleutel in uw code bij om te verwijzen naar de nieuwe primaire toegangssleutel.

PowerShell

Als u de primaire sleutel van Fluid Relay wilt draaien met PowerShell, moet u eerst de Azure Fluid Relay-module installeren.

Install-Module Az.FluidRelay

Volg vervolgens de onderstaande stappen:

1. Werk de toegangssleutels in uw toepassingscode bij om de secundaire toegangssleutel voor Azure Fluid Relay te gebruiken.

2. Roep de opdracht New-AzFluidRelayServerKey aan om de primaire toegangssleutel opnieuw te genereren, zoals wordt weergegeven in het volgende voorbeeld:

New-AzFluidRelayServerKey -FluidRelayServerName <Fluid Relay Service name> -ResourceGroup <resource group> -KeyName <key name>

3. Werk de primaire sleutel in uw code bij om te verwijzen naar de nieuwe primaire toegangssleutel.

Azure-CLI

Als u de primaire sleutel van Fluid Relay wilt draaien met Azure CLI, moet u eerst de fluid-relay-extensie installeren. Zie Instructies.

Volg vervolgens de onderstaande stappen:

1. Werk de toegangssleutels in uw toepassingscode bij om de secundaire toegangssleutel voor Azure Fluid Relay te gebruiken.

2. Roep de opdracht az fluid-relay server regenerate-key aan om de primaire toegangssleutel opnieuw te genereren, zoals wordt weergegeven in het volgende voorbeeld:

az fluid-relay server regenerate-key --resource-group <resource group>--server-name <Fluid Relay Service name>--key-name <key name>

3. Werk de primaire sleutel in uw code bij om te verwijzen naar de nieuwe primaire toegangssleutel.