Integrierte Richtlinien für die Modellbereitstellung im Microsoft Foundry-Portal

Verwenden Sie Azure CLI, um die integrierte Richtliniendefinition zu finden und sie in einem Bereich zuzuweisen.

1. Melden Sie sich an, und wählen Sie das Abonnement aus, in dem Sie arbeiten möchten:

   az login
   az account set --subscription "<subscription-id>"
   

2. Suchen Sie die Richtliniendefinitions-ID für die integrierte Definition:

   az policy definition list \
      --query "[?displayName=='Foundry model deployments should only use approved models'].{name:name, id:id}" \
      --output table
   

   Erwartetes Ergebnis: eine Zeile, die die Richtlinie identhält.

3. Erstellen einer Parameterdatei (Beispiel):

   {
      "effect": {
         "value": "Deny"
      },
      "allowedPublishers": {
         "value": ["OpenAI"]
      },
      "allowedAssetIds": {
         "value": [
            "azureml://registries/azure-openai/models/gpt-5/",
            "azureml://registries/azure-openai/models/gpt-5.2/versions/1"
         ]
      }
   }
   

   Erwartetes Ergebnis: eine JSON-Datei, die Ihren genehmigten Herausgebernamen und Modell-IDs entspricht.

   Wichtig

   Jede Objekt-ID wird als Präfix abgeglichen. Eine ID ohne abschließenden Schrägstrich passt auch zu anderen Modellen, deren Namen mit denselben Zeichen beginnen – zum Beispiel passt azureml://registries/azure-openai/models/gpt-5 zu GPT-5 sowie auch zu GPT-5.2 und GPT-5.4. Fügen Sie einen Schrägstrich am Ende (/) hinzu, um die Übereinstimmung auf genau dieses Modell zu beschränken – zum Beispiel stimmt azureml://registries/azure-openai/models/gpt-5/ nur mit GPT-5 (allen seinen Versionen) überein und schließt GPT-5.2 und GPT-5.4 aus. Um nur eine Version zuzulassen, verwenden Sie die vollständige Objekt-ID, einschließlich der Version (z. B azureml://registries/azure-openai/models/gpt-5.2/versions/1. ).

   Wichtig

   Die Parameternamen in diesem Beispiel müssen mit der richtliniendefinition übereinstimmen, die Sie zuweisen. Wenn sie sich in Ihrem Mandanten unterscheiden, aktualisieren Sie die JSON-Schlüssel so, dass sie den Richtliniendefinitionsparametern entsprechen.

4. Weisen Sie die Richtlinie einem Bereich zu (Beispiel: Abonnementbereich):

   az policy assignment create \
      --name "allow-only-approved-models" \
      --display-name "Allow only approved models" \
      --scope "/subscriptions/<subscription-id>" \
      --policy "<policy-definition-id>" \
      --params @params.json
   

   Erwartetes Ergebnis: Der Befehl gibt eine JSON-Nutzlast zurück, die die Zuordnung identhält.

Verweis:

• Az-Richtliniendefinitionsliste
• az policy assignment erstellen
• Azure Policy Zuweisungen

1. Wählen Sie im Azure-Portal auf der linken Seite der Seite Richtlinie aus. Sie können auch in der Suchleiste oben auf der Seite nach "Richtlinie " suchen.

2. Wählen Sie auf der linken Seite des Azure Policy Dashboards Authoring>Definitions aus. Suchen Sie dann nach Foundry model deployments should only use approved models.

3. Wählen Sie Zuweisen aus, um die Richtlinie zuzuweisen:

   • Bereich: Wählen Sie den Bereich aus, in dem Sie die Richtlinie zuweisen möchten. Der Geltungsbereich kann eine Verwaltungsgruppe, ein Abonnement oder eine Ressourcengruppe sein.
   • Richtliniendefinition: Dieser Abschnitt hat bereits einen Wert von Foundry model deployments should only use approved models.
   • Zuordnungsname: Geben Sie einen eindeutigen Namen für die Zuordnung ein.

   Sie können die Standardwerte für die restlichen Felder beibehalten oder nach Bedarf für Ihre Organisation anpassen.

4. Wählen Sie unten auf der Seite oder auf der Registerkarte "Parameter" oben auf der Seite "Weiter" aus.

5. Auf der Registerkarte Parameter deaktivieren Sie "Nur Parameter anzeigen, die Eingaben oder Überprüfungen benötigen", um alle Felder anzuzeigen.

   • Effekt: Auf "Verweigern" festlegen.

     Hinweis

     Mithilfe der Überwachungsoption können Sie die Richtlinie so konfigurieren, dass Sie Informationen in Ihrem eigenen Compliance-Dashboard protokollieren, bevor Sie die Richtlinie erzwingen.

   • Zulässige Modelle Herausgeber: Geben Sie eine Liste von Herausgebernamen in Anführungszeichen ein, getrennt durch Kommas. Hier ist ein Beispiel, das zeigt, wo ein Herausgebername gefunden werden soll:

     1. Wechseln Sie zum Modellkatalog im Foundry-Portal.

     2. Wählen Sie ein Modell aus (z. B. GPT-5).

     3. Sie finden den Herausgebernamen auf der Modellkarte, wie im folgenden Screenshot gezeigt. In diesem Fall ist es beispielsweise OpenAI.

        

   • Zulässige Objekt-IDs: Geben Sie eine Liste von Modellobjekt-IDs in Anführungszeichen ein, getrennt durch Kommas.

     Zum Abrufen der Modellobjekt-ID-Zeichenfolgen und Modellherausgebernamen führen Sie die folgenden Schritte aus:

     1. Wechseln Sie zum Modellkatalog.

     2. Wählen Sie für jedes Modell, das Sie zulassen möchten, das Modell aus, um die Details anzuzeigen. Kopieren Sie in den Modelldetails den Wert der Modell-ID . Beispielsweise könnte der Wert wie für das GPT-5.2-Modell aussehen azureml://registries/azure-openai/models/gpt-5.2/versions/1 .

        Wichtig

        Jede Objekt-ID wird als Präfix abgeglichen. Eine ID ohne abschließenden Schrägstrich passt auch auf andere Modelle, deren Namen mit denselben Zeichen beginnen – zum Beispiel passt azureml://registries/azure-openai/models/gpt-5 auf GPT-5 sowie auch auf GPT-5.2 und GPT-5.4. Fügen Sie einen abschließenden Schrägstrich hinzu (/) hinzu, um die Übereinstimmung ausschließlich auf dieses bestimmte Modell zu beschränken – zum Beispiel: azureml://registries/azure-openai/models/gpt-5/ passt nur zu GPT-5 (alle Versionen davon). Um nur eine Version zuzulassen, verwenden Sie die vollständige Objekt-ID, einschließlich der Version.

     3. Wählen Sie die Registerkarte "Überprüfen+ Erstellen " aus, und stellen Sie sicher, dass die Richtlinienzuweisung korrekt ist. Wenn Sie fertig sind, wählen Sie "Erstellen" aus, um die Richtlinie zuzuweisen.

     4. Benachrichtigen Sie Ihre Entwickler, dass die Richtlinie vorhanden ist. Sie erhalten eine Fehlermeldung, wenn sie versuchen, ein Modell bereitzustellen, das nicht in der Liste der zulässigen Modelle enthalten ist.

1. Melden Sie sich an, und wählen Sie das Abonnement aus, in dem Sie arbeiten möchten:

   az login
   az account set --subscription "<subscription-id>"
   

2. Suchen Sie die Richtliniendefinitions-ID:

   az policy definition list \
      --query "[?displayName=='Foundry model deployments must meet eligibility requirements'].{name:name, id:id}" \
      --output table
   

3. Erstellen Sie eine Parameterdatei (Beispiel : Vorschaumodelle blockieren, beliebige Quellen zulassen):

   {
      "effect": {
         "value": "Deny"
      },
      "onlyAllowDirectFromAzure": {
         "value": false
      },
      "denyPreviewModels": {
         "value": true
      }
   }
   

4. Weisen Sie die Richtlinie zu:

   az policy assignment create \
      --name "foundry-model-eligibility" \
      --display-name "Foundry model eligibility" \
      --scope "/subscriptions/<subscription-id>" \
      --policy "<policy-definition-id>" \
      --params @params.json
   

1. Wählen Sie im Azure-PortalRichtlinie aus.

2. Wählen SieErstellen>Autorisierungen aus, und suchen Sie nach Foundry model deployments must meet eligibility requirements.

3. Wählen Sie Zuweisen aus.

4. Legen Sie auf der Registerkarte "Grundlagen" den Bereich (Verwaltungsgruppe, Abonnement oder Ressourcengruppe) und einen Zuordnungsnamen fest.

5. Deaktivieren Sie auf der Registerkarte ParameterNur Parameter anzeigen, die eingegeben oder überprüft werden müssen, um alle Felder anzuzeigen:

   • Auswirkung: Auf Ablehnen festlegen, um nicht konforme Bereitstellungen zu blockieren, oder auf Überwachung, um sie zu protokollieren, ohne sie zu blockieren.
   • Nur Direct From Azure zulassen: Auf true festlegen, um die Bereitstellung von Modellen zu verhindern, die nicht Direct From Azure sind. Der Standardwert ist false.
   • Vorschaumodelle verweigern: Festlegen, dass die true Bereitstellung von Modellen verweigert werden soll, deren Lebenszyklusstatus "Vorschau" lautet. Der Standardwert ist false.

6. Wählen Sie Überprüfen + erstellen und dann Erstellen aus, um die Richtlinie zuzuweisen.