Aquesta pàgina s'ha traduït automàticament. Mostra l'article original en anglès.

PMF de resolució de problemes d’incorporació a EKM

Aquest article explica com resoldre els errors de configuració d'EKM a AWS, GCP, Azure i OCI Vault.

Actualització: yesterday

AWS

No autoritzat per executar: sts:AssumeRole

L'usuari arn:aws:sts::xxxxx:assumed-role/EnterpriseKeyManagement/OpenAI-EKM-Service no té autorització per executar sts:AssumeRole sobre el recurs arn:aws:iam::xxxxx:role/xxxxxx

Verifiqueu el principal i l’ExternalId a la política de confiança

Assegureu-vos que hàgiu seguit aquesta secció de la documentació, incloent-hi TANT el reconeixement del principal d’OpenAI com la configuració d’un sts:ExternalId

Si ja heu introduït un sts:ExternalId, assegureu-vos que sigui el mateix ID d’organització d’OpenAI al qual esteu aplicant EKM, i no una altra organització, com ara una organització personal.

Verifiqueu l’associació de la política de confiança amb l’ARN del rol

Verifiqueu que la política de confiança s’hagi desat correctament a l’ARN del rol que heu proporcionat

Comproveu també que hàgiu proporcionat l’ARN del rol correcte. Si el vostre ARN està mal escrit i no existeix, obtindrem el mateix error que si el rol existeix però denega els permisos.

AWS IAM role details with Trust relationships tab open and the role ARN highlighted

No autoritzat per executar: kms:Encrypt al recurs

Usuari: xxxxx no està autoritzat per executar: kms:Encrypt al recurs

Assegureu-vos que la vostra política IAM concedeixi kms:Encrypt i kms:Decrypt al rol d’OpenAI.

Si també heu afegit una política de claus, assegureu-vos que també concedeixi kms:Encrypt i kms:Decrypt al rol d’OpenAI.

GCP

No s’ha pogut obtenir el segment STS de GCP per a l’audiència

No s’ha pogut obtenir el segment STS de GCP per a l’audiència //iam.googleapis.com/projects/xxxxxxxxx/locations/global/workloadIdentityPools/xxxxxxx/providers/xxxxxxxxxx: {'error': 'invalid_request', 'error_description': 'Valor no vàlid per a \"audience\". Aquest valor ha de ser el nom complet del recurs del proveïdor d’identitat. Consulteu https://cloud.google.com/iam/docs/reference/sts/rest/v1/TopLevel/token per veure la llista de formats possibles.

GCP espera una audiència amb el format

iam.googleapis.com/projects/xxxxxxxxx/locations/global/workloadIdentityPools/xxxxxxx/providers/xxxxxxxxxx

Assegureu-vos que hàgiu proporcionat els paràmetres correctes en registrar la clau a OpenAI mitjançant Claus externes a l’API de gestió

  • Assegureu-vos que workload_identity_project_number sigui el número de projecte GCP de 12 dígits

  • Assegureu-vos que workload_identity_pool_id sigui correcte

  • Assegureu-vos que workload_identity_provider_id sigui correcte

L’audiència del segment d’ID no coincideix amb l’audiència esperada

No s’ha pogut obtenir el segment STS de GCP per a l’audiència //iam.googleapis.com/projects/xxxxxx/locations/global/workloadIdentityPools/xxxxxxx/providers/xxxxxxxx: {'error': 'invalid_grant', 'error_description': 'L’audiència del segment d’ID [xxxxx] no coincideix amb l’audiència esperada xxxxxxx.'}

Assegureu-vos que el camp audience que proporcioneu en registrar la configuració amb OpenAI (Claus externes a l'API de gestió) sigui un dels públics permesos del vostre proveïdor d'identitat de càrrega de treball. Us recomanem que utilitzeu l'ID d'organització d'OpenAI.

Azure

A l’aplicació client li falta el principal de servei

A l’aplicació client xxxxx li falta el principal de servei al tenant xxxxx. Consulteu les instruccions aquí: https://go.microsoft.com/fwlink/?linkid=2225119

Assegureu-vos que hàgiu seguit correctament la creació del principal de servei tal com s’indica a les Instruccions d’integració d’OpenAI / Azure EKM.

L’emissor de la crida no està autoritzat a dur a terme l’acció sobre el recurs

L’emissor de la crida no està autoritzat a dur a terme l’acció sobre el recurs. Si les assignacions de rols, les assignacions de denegació o les definicions de rols s’han canviat recentment, espereu el temps de propagació.

Aquest mateix error pot aparèixer per diversos motius

  • Heu proporcionat un nom de clau o un URI de magatzem incorrectes, o bé que no existeixen

  • No heu creat un rol amb aquestes accions de dades I no l'heu assignat a l'entitat de servei d'OpenAI

    • Microsoft.KeyVault/vaults/keys/encrypt/action

    • Microsoft.KeyVault/vaults/keys/decrypt/action

El nom de la clau no coincideix amb el patró

"El valor de 'key_name' no és vàlid: la cadena no coincideix amb el patró. S'esperava una cadena que coincidís amb el patró '^org-[0-9a-zA-Z-]*--[0-9a-zA-Z-]*$'."

Afegiu el vostre ID d’organització d’OpenAI com a prefix al nom de la clau de Key Vault.

Aquesta és la pràctica recomanada per seguretat per evitar que un altre usuari registri la vostra clau de Key Vault. Validem que l’ID de l’organització coincideixi en registrar la clau i en cada sol·licitud al vostre Key Vault.

OCI

Configuració no vàlida o accés denegat

Comprova que el magatzem de claus estigui actiu, que la clau estigui habilitada i que region, vault_ocid i key_ocid identifiquin la mateixa configuració regional. Utilitza els OCID complets de l'àmbit comercial i un nom de regió complet, com ara us-ashburn-1. Tant la teva tenència com la d'OpenAI han d'estar subscrites a la regió seleccionada.

Afegeix a la clau l'etiqueta de format lliure openai_organization_id amb el teu ID d'organització d'OpenAI exacte. Una etiqueta del magatzem de claus o una etiqueta definida no compleix aquest requisit.

Per a EKM, utilitza AES-256 i concedeix a la identitat de producció d'OpenAI el permís VAULT_READ sobre el magatzem de claus i els permisos KEY_READ, KEY_ENCRYPT i KEY_DECRYPT sobre la clau. Limita l'abast de cada permís concedit al recurs corresponent. Omet key_version_ocid.

Per a la recuperació de PSP, utilitza RSA-3072 i l'OCID exacte d'una versió habilitada d'aquesta clau. OpenAI necessita accés de lectura a les metadades i a les claus públiques, però no necessita permís de desxifratge RSA. Per configurar EKM, consulta: Configuració d'OCI Vault per a la gestió de claus empresarials. Per consultar la política de claus de recuperació i els exemples de registre, ves a: Configuració de claus asimètriques — OCI Vault.

Fes una crida a /organization/external_keys/{id}/validate després de corregir la configuració. GET retorna les dades de registre emmagatzemades i no torna a comprovar l'accés a OCI. Quan contactis amb el servei d'assistència d'OpenAI, inclou l'ID de la sol·licitud i una resposta d'error de la qual hagis eliminat les dades sensibles. No hi incloguis claus d'API ni dades de claus privades.

T'ha estat útil aquest article?