Ingebouwd beleid voor modelimplementatie in Microsoft Foundry-portal

Azure Policy biedt ingebouwde beleidsdefinities waarmee u de implementatie van AI-modellen in Microsoft Foundry-portal kunt beheren. U kunt dit beleid gebruiken om te bepalen welke modellen uw ontwikkelaars kunnen implementeren in de Foundry-portal.

Opmerking

Als u modelrouter wilt implementeren en gebruiken terwijl dit beleid is toegewezen, neemt u Microsoft op in de lijst met toegestane uitgevers, omdat Microsoft de uitgever van de modelrouter is. Neem ook de uitgevernaam op van elk ondersteund model dat u implementeert voor routering, zoals vermeld op de kaart van het model in de modelcatalogus. Als u bijvoorbeeld wilt routeren naar Claude-modellen, die u afzonderlijk implementeert, moet u ook Anthropic opnemen. Als de lijst met toegestane uitgevers deze namen niet bevat, blokkeert het beleid de implementatie van de modelrouter.

Voorwaarden

  • Een Azure-account met een actief abonnement. Als u nog geen account hebt, maakt u een vrij Azure account. Met uw Azure-account hebt u toegang tot de Foundry-portal.

  • Machtigingen voor het maken en toewijzen van beleidsregels. Als u beleid wilt maken en toewijzen, moet u een Owner of Resource Policy Contributor zijn op het niveau van Azure abonnement of resourcegroep.

  • Bekendheid met Azure Policy. Zie What is Azure Policy? voor meer informatie.

Microsoft Foundry biedt ingebouwde Azure Policy definities waarmee u kunt bepalen welke modellen in uw organisatie kunnen worden geïmplementeerd. De volgende definities zijn van toepassing op modelimplementaties:

Policy Purpose Status
Implementaties van Foundry-modellen mogen alleen goedgekeurde modellen gebruiken Beperk implementaties tot een specifieke lijst met modellen of uitgevers die uw organisatie expliciet goedkeurt. Algemeen beschikbaar
Implementaties van Foundry-modellen moeten voldoen aan geschiktheidsvereisten Beperk implementaties op basis van modelkenmerken zoals de bron (Direct van Azure) en de levenscyclusstatus (preview). Algemeen beschikbaar

Beide beleidsregels worden geëvalueerd tijdens de implementatie. De catalogus verbergt geen modellen. In plaats daarvan wordt de actie Implementeren uitgeschakeld met een duidelijke reden wanneer een beleid de implementatie blokkeert. U kunt een of beide beleidsregels toewijzen, afhankelijk van uw governancebehoeften.

Opmerking

Deze beleidsregels bepalen ook de onderliggende modellen waaruit de modelrouter selecteert. Modelrouter routeert alleen aanvragen naar modellen die voldoen aan uw toegewezen beleid, dus dezelfde goedkeurings- en geschiktheidsregels gelden, ongeacht of u een model rechtstreeks implementeert of een modelrouter gebruikt om één per aanvraag te kiezen. Daarnaast zijn toegewezen ingebouwde beleidsdefinities voor modelrouter beschikbaar in openbare preview. Deze definities breiden governance uit naar andere aspecten van modelrouterimplementaties, waaronder implementatieregio's, vereiste routeringsregels en configuraties voor logboekregistratie. Zie Implementaties van modelrouters beheren met Azure Policy voor meer informatie.

Hoe deze beleidsregels samenwerken

De twee beleidsregels zijn complementair en hebben betrekking op verschillende governancevragen:

  • Goedgekeurde modellen antwoorden op 'Is dit exacte model op de acceptatielijst van mijn organisatie?' op basis van modelidentiteit.
  • Geschiktheidsvereisten antwoorden op 'Voldoet dit model aan de standaarden van mijn organisatie voor bron en volwassenheid?' op basis van modelkenmerken.

Als u beide beleidsregels toewijst en een model niet compatibel is met beide, toont de implementatie-ervaring eerst de reden met de hoogste prioriteit (goedkeuring en vervolgens geschiktheid), zodat gebruikers één duidelijk, uitvoerbaar bericht krijgen.

Implementaties van Foundry-modellen mogen alleen goedgekeurde modellen gebruiken

Gebruik dit beleid om implementaties te beperken tot een specifieke lijst met modellen of uitgevers die uw organisatie expliciet goedkeurt.

Opmerking

Dit beleid heette voorheen Cognitive Services-implementaties mogen alleen goedgekeurde registermodellen gebruiken. De id van de beleidsdefinitie is ongewijzigd, zodat bestaande toewijzingen zonder enige actie blijven werken.

Het beleid voor goedgekeurde modellen toewijzen

Gebruik Azure CLI om de ingebouwde beleidsdefinitie te vinden en toe te wijzen binnen een bepaald bereik.

  1. Meld u aan en selecteer het abonnement waarin u wilt werken:

    az login
    az account set --subscription "<subscription-id>"
    
  2. Zoek de id van de beleidsdefinitie voor de ingebouwde definitie:

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

    Verwacht resultaat: een rij met het beleid id.

  3. Een parameterbestand maken (voorbeeld):

    {
       "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"
          ]
       }
    }
    

    Verwacht resultaat: een JSON-bestand dat overeenkomt met uw goedgekeurde uitgeversnamen en model-id's.

    Belangrijk

    Elke asset-ID wordt als voorvoegsel gematcht. Een id zonder een afsluitende slash komt ook overeen met andere modellen waarvan de namen beginnen met dezelfde tekens, azureml://registries/azure-openai/models/gpt-5 bijvoorbeeld komt overeen met GPT-5 en ook GPT-5.2 en GPT-5.4. Voeg een afsluitende slash (/) toe om de overeenkomst met dat specifieke model te beperken, bijvoorbeeld azureml://registries/azure-openai/models/gpt-5/ komt alleen overeen met GPT-5 (alle versies) en sluit GPT-5.2 en GPT-5.4 uit. Als u slechts één versie wilt toestaan, gebruikt u de volledige asset-id, inclusief de versie (bijvoorbeeld azureml://registries/azure-openai/models/gpt-5.2/versions/1).

    Belangrijk

    De parameternamen in dit voorbeeld moeten overeenkomen met de beleidsdefinitie die u toewijst. Als deze verschillen in uw tenant, werkt u de JSON-sleutels bij zodat deze overeenkomen met de beleidsdefinitieparameters.

  4. Wijs het beleid toe aan een toepassingsgebied (bijvoorbeeld: abonnementstoepassingsgebied):

    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
    

    Verwacht resultaat: de opdracht retourneert een JSON-nettolading die de toewijzing idbevat.

Verwijzing:

Implementaties van Foundry-modellen moeten voldoen aan geschiktheidsvereisten

Gebruik dit beleid om implementaties te beperken op basis van modelkenmerken in plaats van een specifieke modelidentiteit. Deze beperking is handig als u bredere organisatiestandaarden wilt afdwingen, bijvoorbeeld 'geen preview-modellen in productie' of 'alleen Microsoft-directe modellen', zonder een expliciete acceptatielijst te onderhouden.

Het beleid ondersteunt momenteel de volgende kenmerken:

Parameter Type Default Gedrag wanneer true
onlyAllowDirectFromAzure Boolean false Hiermee weigert u de implementatie van modellen die niet direct zijn van Azure.
denyPreviewModels Boolean false De implementatie van modellen waarvan de levenscyclusstatus preview is, wordt geweigerd.

Beide parameters zijn standaard ingesteld falseop, dus een niet-geconfigureerde toewijzing legt geen beperkingen op. Schakel de wisselknoppen in die overeenkomen met het houding van uw organisatie.

Wijs het beleid voor geschiktheid toe

  1. Meld u aan en selecteer het abonnement waarin u wilt werken:

    az login
    az account set --subscription "<subscription-id>"
    
  2. Zoek de id van de beleidsdefinitie:

    az policy definition list \
       --query "[?displayName=='Foundry model deployments should meet eligibility requirements'].{name:name, id:id}" \
       --output table
    
  3. Een parameterbestand maken (voorbeeld: preview-modellen blokkeren, bron toestaan):

    {
       "effect": {
          "value": "Deny"
       },
       "onlyAllowDirectFromAzure": {
          "value": false
       },
       "denyPreviewModels": {
          "value": true
       }
    }
    
  4. Wijs het beleid toe:

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

Wat ontwikkelaars zien wanneer een implementatie wordt geblokkeerd

Wanneer een ontwikkelaar probeert een model te implementeren dat door een beleid wordt geblokkeerd, wordt de actie Implementeren uitgeschakeld en wordt in een bericht uitgelegd waarom. Het model zelf blijft zichtbaar in de catalogus, zodat de ontwikkelaar begrijpt wat er is geprobeerd.

Scenario Wat de ontwikkelaar ziet
Het model wordt goedgekeurd en komt in aanmerking Implementeren is ingeschakeld.
Model staat niet in de goedgekeurde lijst Implementatie uitgeschakeld — het bericht geeft aan dat het model niet is goedgekeurd door de organisatie, met de instructie contact op te nemen met de abonnements- of Foundry-beheerder.
Het model is goedgekeurd, maar voldoet niet aan geschiktheid (bijvoorbeeld een preview-model wanneer denyPreviewModels het is ingeschakeld) Implementeren uitgeschakeld: het bericht geeft aan dat het model niet voldoet aan de geschiktheidsvereisten van de organisatie (bron- of levenscyclusstatus), met een aanwijzer om contact op te leggen met de beheerder.
Met meerdere beleidsregels wordt de implementatie geblokkeerd Implementeren uitgeschakeld — de reden met de hoogste prioriteit wordt weergegeven (eerst goedkeuring, daarna geschiktheid).

Elk bericht bevat de beleidsnaam en toewijzings-id , zodat beheerders snel kunnen bepalen welk beleid de beperking afdwingt.

Toezicht houden op naleving

Volg deze stappen om de naleving van het beleid te controleren:

  1. Selecteer vanuit de Azure portal, Policy aan de linkerkant van de pagina. U kunt ook zoeken naar Beleid in de zoekbalk boven aan de pagina.

  2. Selecteer aan de linkerkant van het Azure Policy Dashboard Compliance. Elke beleidstoewijzing wordt vermeld met de nalevingsstatus. Als u meer details wilt weergeven, selecteert u de beleidstoewijzing.

De beleidstoewijzing bijwerken

Volg deze stappen om een bestaande beleidstoewijzing bij te werken met nieuwe modellen:

  1. Selecteer vanuit de Azure portal, Policy aan de linkerkant van de pagina. U kunt ook zoeken naar Beleid in de zoekbalk boven aan de pagina.
  2. Selecteer aan de linkerkant van het Azure Policy Dashboard Toewijzingen en zoek de bestaande beleidstoewijzing. Selecteer het beletselteken (...) naast de opdracht en selecteer Opdracht bewerken.
  3. Werk het tabblad Parameters, Toegestane Asset-ID's en Toegestane Modellenuitgevers bij met de nieuwe goedgekeurde model-ID's en uitgeversnamen.
  4. Selecteer Opslaan op het tabblad Controleren en opslaan om de beleidstoewijzing bij te werken.

Beste praktijken

  • Granulaire afbakening: wijs beleidsregels toe op het juiste bereik om controle en flexibiliteit in evenwicht te brengen. U kunt bijvoorbeeld op abonnementsniveau alle resources in het abonnement beheren of toepassen op het niveau van de resourcegroep om resources in een specifieke groep te beheren.
  • Beleidsnaamgeving: gebruik een consistente naamconventie voor beleidstoewijzingen om het doel van het beleid gemakkelijker te identificeren. Neem informatie op, zoals het doel en het bereik in de naam.
  • Tags: Gebruik tags om uw beleid te categoriseren en te beheren. Tagbeleid, bijvoorbeeld tagbeleidsregels per omgeving (dev, test, prod) of per afdeling.
  • Documentatie: Houd records bij van beleidstoewijzingen en configuraties voor controledoeleinden. Documenteer eventuele wijzigingen in het beleid in de loop van de tijd.
  • Regelmatige beoordelingen: controleer regelmatig beleidstoewijzingen om ervoor te zorgen dat deze overeenkomen met de vereisten van uw organisatie.
  • Testen: Test beleidsregels in een niet-productieomgeving voordat u deze toepast op productiebronnen.
  • Communicatie: zorg ervoor dat ontwikkelaars op de hoogte zijn van het beleid en de gevolgen voor hun werk begrijpen.

Effectiviteit van beleid controleren

Nadat u het beleid hebt toegewezen, controleert u of het werkt zoals verwacht:

  1. Wacht ten minste 15 minuten totdat de beleidstoewijzing van kracht wordt. Nieuwe opdrachten zijn niet direct van toepassing.

  2. Probeer een model uit te rollen dat niet op de lijst met toegestane modellen staat. Als het beleid gebruikmaakt van het effect Weigeren , mislukt de implementatie met een beleidsschendingsfout.

  3. Controleer of het implementeren van een goedgekeurd model nog steeds slaagt.

  4. Controleer het dashboard Compliance in Azure Policy om te controleren of het beleid resources correct evalueert. Niet-compatibele resources worden binnen één evaluatiecyclus voor naleving weergegeven (meestal maximaal 24 uur).

Problemen met beleidstoewijzingen oplossen

Symptoom Oorzaak Resolutie
Beleidstoewijzing mislukt met een machtigingsfout Uw account mist de rol Eigenaar of Inzender voor resourcebeleid in het doelbereik. Wijs de vereiste rol toe en probeer het opnieuw. Zie Vereisten.
Beleid blokkeert niet niet-compatibele implementaties De beleidstoewijzing is nog niet doorgegeven of het effect is ingesteld op Controleren in plaats van Weigeren. Wacht ten minste 15 minuten en probeer het opnieuw. Controleer of de parameter Effect is ingesteld op Weigeren.
Goedgekeurd model wordt onverwacht geblokkeerd De modelasset-ID of uitgeversnaam in de beleidsparameters komt niet exact overeen met het model. Vergelijk de parameterwaarden met de modelkaart in de modelcatalogus. Asset-ID's en uitgeversnamen zijn hoofdlettergevoelig.
In het nalevingsdashboard worden geen gegevens weergegeven De nalevingsevaluatie is nog niet voltooid. Azure Policy evalueert nieuwe opdrachten binnen 24 uur. Wacht op de volgende evaluatiecyclus of activeer een evaluatiescan op aanvraag.
Fout bij niet-overeenkomende parameternaam tijdens toewijzing De JSON-parametersleutels komen niet overeen met de beleidsdefinitie. Voer deze az policy definition show --name "<definition-id>" opdracht uit om de exacte parameternamen op te halen uit de definitie. Gebruiken allowedPublishers en allowedAssetIds.