Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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.
Meld u aan en selecteer het abonnement waarin u wilt werken:
az login az account set --subscription "<subscription-id>"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 tableVerwacht resultaat: een rij met het beleid
id.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-5bijvoorbeeld 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, bijvoorbeeldazureml://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 (bijvoorbeeldazureml://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.
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.jsonVerwacht resultaat: de opdracht retourneert een JSON-nettolading die de toewijzing
idbevat.
Verwijzing:
- az lijst met beleidsdefinities
- az policy assignment create - beleidstoewijzing maken
- Azure Policy toewijzingen
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
Meld u aan en selecteer het abonnement waarin u wilt werken:
az login az account set --subscription "<subscription-id>"Zoek de id van de beleidsdefinitie:
az policy definition list \ --query "[?displayName=='Foundry model deployments should meet eligibility requirements'].{name:name, id:id}" \ --output tableEen parameterbestand maken (voorbeeld: preview-modellen blokkeren, bron toestaan):
{ "effect": { "value": "Deny" }, "onlyAllowDirectFromAzure": { "value": false }, "denyPreviewModels": { "value": true } }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:
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.
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:
- 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.
- 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.
- Werk het tabblad Parameters, Toegestane Asset-ID's en Toegestane Modellenuitgevers bij met de nieuwe goedgekeurde model-ID's en uitgeversnamen.
- 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:
Wacht ten minste 15 minuten totdat de beleidstoewijzing van kracht wordt. Nieuwe opdrachten zijn niet direct van toepassing.
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.
Controleer of het implementeren van een goedgekeurd model nog steeds slaagt.
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. |