AzureSasCredential Klasse
- java.
lang. Object - com.
azure. core. credential. AzureSasCredential
- com.
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. |
Azure |
update(String signature)
Rotiert die shared access signature, die diesen Anmeldeinformationen zugeordnet ist. |
Geerbte Methoden von java.lang.Object
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:
AzureSasCredential
public AzureSasCredential(String signature, Function
Erstellt eine Anmeldeinformation, die die Anforderung innerhalb der angegebenen Shared Access Signature autorisiert.
Wenn signatureEncoder
ungleich NULL ist, werden und signature
alle 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
codiert.
Details zur Methode
getSignature
public String getSignature()
Ruft die shared access signature ab, die diesen Anmeldeinformationen zugeordnet ist.
Returns:
update
public AzureSasCredential update(String signature)
Rotiert die shared access signature, die diesen Anmeldeinformationen zugeordnet ist.
Parameters:
Returns:
AzureSasCredential
Objekt.Gilt für:
Azure SDK for Java