Een aangepaste rol maken

In deze handleiding leert u hoe u een aangepaste rol maakt voor serviceoperators. Een aangepaste rol biedt de benodigde machtigingen voor toegang tot Azure Operator Service Manager (AOSM) Publisher-resources bij het implementeren van een SNS (Site Network Service).

Vereisten

Neem contact op met uw Microsoft-accountteam om uw Azure-abonnement te registreren voor toegang tot Azure Operator Service Manager (AOSM) of om uw interesse uit te spreken via het partnerregistratieformulier.

Machtigingen/acties die zijn vereist voor de aangepaste rol

• Microsoft.HybridNetwork/Publishers/NetworkFunctionDefinitionGroups/NetworkFunctionDefinitionVersions/use/action

• Microsoft.HybridNetwork/Publishers/NetworkFunctionDefinitionGroups/NetworkFunctionDefinitionVersions/read

• Microsoft.HybridNetwork/Publishers/NetworkServiceDesignGroups/NetworkServiceDesignVersions/use/action

• Microsoft.HybridNetwork/Publishers/NetworkServiceDesignGroups/NetworkServiceDesignVersions/read

• Microsoft.HybridNetwork/Publishers/ConfigurationGroupSchemas/read

Het bereik bepalen

Bepaal het bereik waaraan u de rol wilt toewijzen:

• Als de uitgeversresources zich in één resourcegroep bevinden, kunt u het toewijsbare bereik van die resourcegroep gebruiken.

• Als de uitgeversresources zijn verdeeld over meerdere resourcegroepen binnen één abonnement, moet u het toewijsbare bereik van dat abonnement gebruiken.

• Als de uitgeversresources zijn verdeeld over meerdere abonnementen, moet u een aangepaste rol maken die aan elk van deze abonnementen kan worden toegewezen.

Aangepaste rol maken met Bicep

Een aangepaste rol maken met Bicep. Zie Aangepaste Azure-rollen maken of bijwerken met Bicep voor meer informatie

U kunt bijvoorbeeld het volgende voorbeeld gebruiken als de main.bicep-sjabloon. In dit voorbeeld wordt de rol gemaakt met een toewijsbaar bereik voor het hele abonnement.

targetScope = 'subscription'

@description('Array of actions for the roleDefinition')
param actions array = [
  'Microsoft.HybridNetwork/Publishers/NetworkFunctionDefinitionGroups/NetworkFunctionDefinitionVersions/use/action'
  'Microsoft.HybridNetwork/Publishers/NetworkFunctionDefinitionGroups/NetworkFunctionDefinitionVersions/read'
  'Microsoft.HybridNetwork/Publishers/NetworkServiceDesignGroups/NetworkServiceDesignVersions/use/action'
  'Microsoft.HybridNetwork/Publishers/NetworkServiceDesignGroups/NetworkServiceDesignVersions/read'
  'Microsoft.HybridNetwork/Publishers/ConfigurationGroupSchemas/read'
]

@description('Array of notActions for the roleDefinition')
param notActions array = []

@description('Friendly name of the role definition')
param roleName string = 'Custom Role - AOSM Service Operator access to Publisher'

@description('Detailed description of the role definition')
param roleDescription string = 'Provides read and use access to AOSM Publisher resources'

var roleDefName = guid(subscription().id, string(actions), string(notActions))

resource roleDef 'Microsoft.Authorization/roleDefinitions@2022-04-01' = {
  name: roleDefName
  properties: {
    roleName: roleName
    description: roleDescription
    type: 'customRole'
    permissions: [
      {
        actions: actions
        notActions: notActions
      }
    ]
    assignableScopes: [
      subscription().id
    ]
  }
}

Wanneer u de sjabloon implementeert, moet deze worden geïmplementeerd in hetzelfde abonnement als de Publisher-resources.

az login

az account set --subscription <publisher subscription>

az deployment sub create --location <location> --name customRole --template-file main.bicep 

Een aangepaste rol maken met behulp van Azure Portal

Maak een aangepaste rol met behulp van Azure Portal. Zie Aangepaste Azure-rollen maken of bijwerken met behulp van Azure Portal voor meer informatie

Als u wilt, kunt u de meeste aangepaste rolwaarden opgeven in een JSON-bestand.

Voorbeeld-JSON:

{
  "$schema": "https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.22.6.54827",
      "templateHash": "14238097231376848271"
    }
  },
  "parameters": {
    "actions": {
      "type": "array",
      "defaultValue": [
        "Microsoft.HybridNetwork/Publishers/NetworkFunctionDefinitionGroups/NetworkFunctionDefinitionVersions/use/action",
        "Microsoft.HybridNetwork/Publishers/NetworkFunctionDefinitionGroups/NetworkFunctionDefinitionVersions/read",
        "Microsoft.HybridNetwork/Publishers/NetworkServiceDesignGroups/NetworkServiceDesignVersions/use/action",
        "Microsoft.HybridNetwork/Publishers/NetworkServiceDesignGroups/NetworkServiceDesignVersions/read",
        "Microsoft.HybridNetwork/Publishers/ConfigurationGroupSchemas/read"
      ],
      "metadata": {
        "description": "Array of actions for the roleDefinition"
      }
    },
    "notActions": {
      "type": "array",
      "defaultValue": [],
      "metadata": {
        "description": "Array of notActions for the roleDefinition"
      }
    },
    "roleName": {
      "type": "string",
      "defaultValue": "Custom Role - AOSM Service Operator Role",
      "metadata": {
        "description": "Friendly name of the role definition"
      }
    },
    "roleDescription": {
      "type": "string",
      "defaultValue": "Role Definition for AOSM Service Operator Role",
      "metadata": {
        "description": "Detailed description of the role definition"
      }
    }
  },
  "variables": {
    "roleDefName": "[guid(subscription().id, string(parameters('actions')), string(parameters('notActions')))]"
  },
  "resources": [
    {
      "type": "Microsoft.Authorization/roleDefinitions",
      "apiVersion": "2022-04-01",
      "name": "[variables('roleDefName')]",
      "properties": {
        "roleName": "[parameters('roleName')]",
        "description": "[parameters('roleDescription')]",
        "type": "customRole",
        "permissions": [
          {
            "actions": "[parameters('actions')]",
            "notActions": "[parameters('notActions')]"
          }
        ],
        "assignableScopes": [
          "[subscription().id]"
        ]
      }
    }
  ]
}

Volgende stappen

• Een aangepaste rol toewijzen