Ta strona została przetłumaczona maszynowo. Wyświetl oryginalny artykuł w języku angielskim.

FAQ dotyczące rozwiązywania problemów z wdrażaniem EKM

Ten artykuł wyjaśnia, jak rozwiązywać błędy konfiguracji EKM w AWS, GCP, Azure i OCI Vault.

Zaktualizowano: 2 days ago

AWS

Brak uprawnień do wykonania: sts:AssumeRole

Użytkownik: arn:aws:sts::xxxxx:assumed-role/EnterpriseKeyManagement/OpenAI-EKM-Service nie ma uprawnień do wykonania operacji: sts:AssumeRole na zasobie: arn:aws:iam::xxxxx:role/xxxxxx

Zweryfikuj element principal i ExternalId w zasadach zaufania

Upewnij się, że wykonano tę sekcję dokumentacji, w tym OBA wymagane kroki: rozpoznanie elementu principal OpenAI oraz skonfigurowanie sts:ExternalId

Jeśli dodano już sts:ExternalId, upewnij się, że jest to ten sam identyfikator organizacji OpenAI, do której stosujesz EKM, a nie inna organizacja, np. osobista.

Zweryfikuj powiązanie zasad zaufania z ARN roli

Sprawdź, czy zasady zaufania zostały prawidłowo zapisane dla podanego ARN roli

Sprawdź też, czy podano właściwy ARN roli. Jeśli Twój ARN zawiera literówkę i nie istnieje, otrzymamy ten sam błąd, co wtedy, gdy rola istnieje, ale odmawia uprawnień.

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

Brak uprawnień do wykonania: kms:Encrypt na zasobie

Użytkownik: xxxxx nie ma uprawnień do wykonania: kms:Encrypt na zasobie

Upewnij się, że Twoje zasady IAM przyznają roli OpenAI uprawnienia kms:Encrypt i kms:Decrypt.

Jeśli dodano również zasady klucza, upewnij się, że one także przyznają roli OpenAI uprawnienia kms:Encrypt i kms:Decrypt.

GCP

Nie udało się uzyskać tokenu GCP STS dla odbiorcy

Nie udało się uzyskać tokenu GCP STS dla odbiorcy //iam.googleapis.com/projects/xxxxxxxxx/locations/global/workloadIdentityPools/xxxxxxx/providers/xxxxxxxxxx: {'error': 'invalid_request', 'error_description': 'Nieprawidłowa wartość \"audience\". Ta wartość powinna być pełną nazwą zasobu dostawcy tożsamości. Listę możliwych formatów znajdziesz na https://cloud.google.com/iam/docs/reference/sts/rest/v1/TopLevel/token

GCP oczekuje odbiorcy w formacie

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

Upewnij się, że podczas rejestrowania klucza w OpenAI za pomocą Kluczy zewnętrznych w interfejsie Management API podano prawidłowe parametry

  • Upewnij się, że workload_identity_project_number to 12-cyfrowy numer projektu GCP

  • Upewnij się, że workload_identity_pool_id jest poprawny

  • Upewnij się, że workload_identity_provider_id jest poprawny

Odbiorca w tokenie ID nie odpowiada oczekiwanemu odbiorcy

Nie udało się uzyskać tokenu GCP STS dla odbiorcy //iam.googleapis.com/projects/xxxxxx/locations/global/workloadIdentityPools/xxxxxxx/providers/xxxxxxxx: {'error': 'invalid_grant', 'error_description': 'Odbiorca w tokenie ID [xxxxx] nie odpowiada oczekiwanemu odbiorcy xxxxxxx.'}

Upewnij się, że pole audience podane podczas rejestrowania konfiguracji w OpenAI (Klucze zewnętrzne w interfejsie Management API) zawiera jedną z dozwolonych grup odbiorców skonfigurowanych u dostawcy tożsamości obciążenia. Zalecamy użycie ID organizacji OpenAI.

Azure

W aplikacji klienckiej brakuje jednostki usługi

W aplikacji klienckiej xxxxx brakuje jednostki usługi w dzierżawie xxxxx. Instrukcje znajdziesz tutaj: https://go.microsoft.com/fwlink/?linkid=2225119

Upewnij się, że dokładnie wykonano procedurę tworzenia jednostki usługi opisaną w instrukcji integracji OpenAI / Azure EKM.

Wywołujący nie ma uprawnień do wykonania działania na zasobie

Wywołujący nie ma uprawnień do wykonania działania na zasobie. Jeśli przypisania ról, przypisania odmowy lub definicje ról zostały niedawno zmienione, uwzględnij czas propagacji.

Ten sam błąd może wystąpić z kilku powodów

  • Podano nieprawidłową nazwę klucza lub identyfikator URI magazynu albo wskazano element, który nie istnieje

  • Nie utworzono roli z tymi akcjami na danych ORAZ nie przypisano jej jednostce usługi OpenAI

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

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

Nazwa klucza nie pasuje do wzorca

„Nieprawidłowa wartość «key_name»: ciąg znaków nie pasuje do wzorca. Oczekiwano ciągu zgodnego ze wzorcem «^org-[0-9a-zA-Z-]*--[0-9a-zA-Z-]*$».”

Poprzedź nazwę klucza Key Vault identyfikatorem organizacji OpenAI.

To zalecana przez zespół ds. bezpieczeństwa najlepsza praktyka, która zapobiega zarejestrowaniu klucza z magazynu kluczy przez innego użytkownika. Sprawdzamy zgodność identyfikatora organizacji podczas rejestracji klucza i przy każdym żądaniu do Twojego magazynu kluczy.

OCI

Nieprawidłowa konfiguracja lub odmowa dostępu

Sprawdź, czy magazyn jest aktywny, klucz jest włączony, a region, vault_ocid i key_ocid wskazują tę samą konfigurację regionalną. Używaj pełnych identyfikatorów OCID ze środowiska komercyjnego i pełnej nazwy regionu, np. us-ashburn-1. Zarówno Twoja dzierżawa, jak i dzierżawa OpenAI muszą subskrybować wybrany region.

Dodaj do klucza tag swobodny openai_organization_id z dokładnym ID Twojej organizacji OpenAI. Tag magazynu ani tag zdefiniowany nie spełniają tego wymogu.

W przypadku EKM użyj AES-256 i nadaj tożsamości produkcyjnej OpenAI uprawnienie VAULT_READ do magazynu oraz KEY_READ, KEY_ENCRYPT i KEY_DECRYPT do klucza. Ogranicz każde nadawane uprawnienie do właściwego zasobu. Pomiń key_version_ocid.

Do odzyskiwania PSP użyj RSA-3072 i dokładnego identyfikatora OCID włączonej wersji tego klucza. OpenAI potrzebuje dostępu do odczytu metadanych i kluczy publicznych, ale nie potrzebuje uprawnienia do odszyfrowywania RSA. Informacje o konfiguracji EKM znajdziesz w artykule: Konfigurowanie OCI Vault na potrzeby zarządzania kluczami w przedsiębiorstwie. Zasady dotyczące klucza odzyskiwania i przykłady rejestracji znajdziesz w sekcji: Konfigurowanie kluczy asymetrycznych — OCI Vault.

Po poprawieniu konfiguracji wywołaj /organization/external_keys/{id}/validate. GET zwraca zapisane dane rejestracji i nie sprawdza ponownie dostępu do OCI. Kontaktując się z pomocą techniczną OpenAI, podaj identyfikator żądania i dołącz odpowiedź z błędem po usunięciu danych poufnych. Nie dołączaj kluczy API ani danych kluczy prywatnych.

Czy ten artykuł był pomocny?