EnvironmentCredential class
Umożliwia uwierzytelnianie do identyfikatora Microsoft Entra przy użyciu klucza tajnego klienta lub certyfikatu.
Konstruktory
| Environment |
Tworzy wystąpienie klasy EnvironmentCredential i decyduje o użyciu poświadczeń w zależności od dostępnych zmiennych środowiskowych. Wymagane zmienne środowiskowe:
Jeśli ustawisz AZURE_TENANT_ID, możesz również ustawić dodatkowo dozwolone dzierżawy
Zmienne środowiskowe używane do uwierzytelniania poświadczeń klienta:
Uwierzytelnianie za pomocą nazwy użytkownika i hasła jest przestarzałe, ponieważ nie obsługuje uwierzytelniania wieloskładnikowego (MFA). Aby uzyskać więcej informacji, zobacz https://aka.ms/azsdk/identity/mfa. Użytkownicy nadal mogą podawać zmienne środowiskowe dla tej metody uwierzytelniania:
Jeśli brakuje zmiennych środowiskowych wymaganych do przeprowadzenia uwierzytelniania, zostanie zgłoszony CredentialUnavailableError. Jeśli uwierzytelnianie zakończy się niepowodzeniem lub wystąpi nieznany błąd, zostanie zgłoszony błąd AuthenticationError. |
Metody
| get |
Uwierzytelnia się przy użyciu identyfikatora Entra firmy Microsoft i zwraca token dostępu, jeśli się powiedzie. |
Szczegóły konstruktora
EnvironmentCredential(EnvironmentCredentialOptions)
Tworzy wystąpienie klasy EnvironmentCredential i decyduje o użyciu poświadczeń w zależności od dostępnych zmiennych środowiskowych.
Wymagane zmienne środowiskowe:
-
AZURE_TENANT_ID: identyfikator dzierżawy (katalogu) firmy Microsoft. -
AZURE_CLIENT_ID: identyfikator klienta (aplikacji) rejestracji aplikacji w dzierżawie.
Jeśli ustawisz AZURE_TENANT_ID, możesz również ustawić dodatkowo dozwolone dzierżawy
-
AZURE_ADDITIONALLY_ALLOWED_TENANTS: w przypadku aplikacji wielodostępnych określa dodatkowe dzierżawy, dla których poświadczenia mogą uzyskiwać tokeny z pojedynczym ciągiem rozdzielanym średnikami. Użyj * , aby zezwolić na wszystkie dzierżawy.
Zmienne środowiskowe używane do uwierzytelniania poświadczeń klienta:
-
AZURE_CLIENT_SECRET: wpis tajny klienta wygenerowany na potrzeby rejestracji aplikacji. -
AZURE_CLIENT_CERTIFICATE_PATH: ścieżka do certyfikatu PEM do użycia podczas uwierzytelniania zamiast klucza tajnego klienta. -
AZURE_CLIENT_CERTIFICATE_PASSWORD: (opcjonalnie) hasło do pliku certyfikatu. -
AZURE_CLIENT_SEND_CERTIFICATE_CHAIN: (opcjonalnie) wskazuje, że łańcuch certyfikatów powinien być ustawiony w nagłówku x5c w celu obsługi uwierzytelniania opartego na nazwie podmiotu/wystawcy.
Uwierzytelnianie za pomocą nazwy użytkownika i hasła jest przestarzałe, ponieważ nie obsługuje uwierzytelniania wieloskładnikowego (MFA). Aby uzyskać więcej informacji, zobacz https://aka.ms/azsdk/identity/mfa. Użytkownicy nadal mogą podawać zmienne środowiskowe dla tej metody uwierzytelniania:
-
AZURE_USERNAME: nazwa użytkownika do uwierzytelnienia. -
AZURE_PASSWORD: hasło do uwierzytelniania za pomocą.
Jeśli brakuje zmiennych środowiskowych wymaganych do przeprowadzenia uwierzytelniania, zostanie zgłoszony CredentialUnavailableError. Jeśli uwierzytelnianie zakończy się niepowodzeniem lub wystąpi nieznany błąd, zostanie zgłoszony błąd AuthenticationError.
new EnvironmentCredential(options?: EnvironmentCredentialOptions)
Parametry
- options
- EnvironmentCredentialOptions
Opcje konfigurowania klienta, który wysyła żądanie uwierzytelniania.
Szczegóły metody
getToken(string | string[], GetTokenOptions)
Uwierzytelnia się przy użyciu identyfikatora Entra firmy Microsoft i zwraca token dostępu, jeśli się powiedzie.
function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>
Parametry
- scopes
-
string | string[]
Lista zakresów, dla których token będzie miał dostęp.
- options
- GetTokenOptions
Parametry opcjonalne. Zobacz GetTokenOptions.
Zwraca
Promise<AccessToken>