AzureSasCredential Klasse

  • Referenz
Paket:
com.azure.core.credential
Maven-Artefakt:
com.azure:azure-core:1.46.0
  • java.lang.Object
    • com.azure.core.credential.AzureSasCredential

public final class AzureSasCredential

Stellt eine Anmeldeinformation dar, die eine Shared Access Signature verwendet, um sich bei einem Azure-Dienst zu authentifizieren. Sie wird zum Authentifizieren und Autorisieren des Zugriffs auf Azure-Dienste mithilfe einer Shared Access Signature verwendet.

Eine Shared Access Signature ist ein zeichenfolgenbasiertes Token, das für einen bestimmten Zeitraum begrenzte Berechtigungen und Zugriff auf bestimmte Ressourcen innerhalb eines Azure-Diensts gewährt. Es ermöglicht Ihnen, zeitlich begrenzten Zugriff auf Ihre Ressourcen zu ermöglichen, ohne Ihren Kontoschlüssel oder andere vertrauliche Anmeldeinformationen freizugeben.

Mit AzureSasCredential können Sie azure-Dienste authentifizieren und darauf zugreifen, die shared access signatures unterstützen. Wenn Sie eine instance der AzureSasCredential -Klasse erstellen und das SAS-Token als Parameter bereitstellen, können Sie diese Anmeldeinformationen verwenden, um Anforderungen an Azure-Dienste zu authentifizieren.

Um die Anmeldeinformationen zu verwenden, übergeben Sie sie in der Regel während der Instanziierung an den entsprechenden Azure-Client- oder Dienstclient-Generator. Die Bibliothek verarbeitet den Authentifizierungsprozess intern und schließt das SAS-Token in die HTTP-Anforderungen ein, die an den Azure-Dienst gesendet werden, sodass Sie auf die im SAS-Token angegebenen Ressourcen zugreifen können.

Die AzureSasCredential ist besonders nützlich, wenn Sie temporären und eingeschränkten Zugriff auf bestimmte Ressourcen wie Azure Storage-Container, Blobs, Warteschlangen oder Dateien gewähren müssen, ohne Ihren Kontoschlüssel offenlegen zu müssen.

Es ist wichtig zu beachten, dass die Verfügbarkeit und Nutzung von AzureSasCredential möglicherweise vom spezifischen Azure-Dienst und seiner Unterstützung für Shared Access Signaturen abhängen. Darüber hinaus können das Format und der Inhalt des SAS-Tokens je nach Dienst und Ressource variieren, auf den Sie abzielen.

Beispiel: Azure SAS-Authentifizierung

Im folgenden Codebeispiel wird die Erstellung eines AzureSasCredentialveranschaulicht, wobei das sas-Token zum Konfigurieren verwendet wird.

AzureSasCredential azureSasCredential =
     new AzureSasCredential("AZURE-SERVICE-SAS-KEY");

Zusammenfassung zum Konstruktor

Konstruktor Beschreibung
AzureSasCredential(String signature)

Erstellt eine Anmeldeinformation, die die Anforderung mit der angegebenen Shared Access Signature autorisiert.
AzureSasCredential(String signature, Function<String,String> signatureEncoder)

Erstellt eine Anmeldeinformation, die die Anforderung innerhalb der angegebenen Shared Access Signature autorisiert.

Methodenzusammenfassung

Modifizierer und Typ Methode und Beschreibung
String getSignature()

Ruft die shared access signature ab, die diesen Anmeldeinformationen zugeordnet ist.
AzureSasCredential update(String signature)

Rotiert die shared access signature, die diesen Anmeldeinformationen zugeordnet ist.

Geerbte Methoden von java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Details zum Konstruktor

AzureSasCredential

public AzureSasCredential(String signature)

Erstellt eine Anmeldeinformation, die die Anforderung mit der angegebenen Shared Access Signature autorisiert.

Es signature wird davon ausgegangen, dass das übergebene codiert ist. Dieser Konstruktor ist praktisch identisch mit dem Aufrufen AzureSasCredential(String signature, Function<String,String> signatureEncoder)von .

Parameters:

signature - Die freigegebene Zugriffssignatur, die zum Autorisieren von Anforderungen verwendet wird.

AzureSasCredential

public AzureSasCredential(String signature, Function signatureEncoder)

Erstellt eine Anmeldeinformation, die die Anforderung innerhalb der angegebenen Shared Access Signature autorisiert.

Wenn signatureEncoder ungleich NULL ist, werden und signaturealle updated signaturesmit der -Funktion codiert. signatureEncoder sollte so idempotent wie möglich sein, um die Wahrscheinlichkeit von Fehlern bei der doppelten Codierung zu verringern.

Parameters:

signature - Die freigegebene Zugriffssignatur, die zum Autorisieren von Anforderungen verwendet wird.
signatureEncoder - Eine optionale Funktion, die den signaturecodiert.

Details zur Methode

getSignature

public String getSignature()

Ruft die shared access signature ab, die diesen Anmeldeinformationen zugeordnet ist.

Returns:

Die Freigegebene Zugriffssignatur, die zum Autorisieren von Anforderungen verwendet wird.

update

public AzureSasCredential update(String signature)

Rotiert die shared access signature, die diesen Anmeldeinformationen zugeordnet ist.

Parameters:

signature - Die neue Shared Access Signature, die diesen Anmeldeinformationen zugeordnet werden soll.

Returns:

Das aktualisierte AzureSasCredential Objekt.

Gilt für: