Integrowanie usługi Azure Files z łącznikiem usługi

Na tej stronie przedstawiono obsługiwane metody uwierzytelniania i klientów oraz pokazano przykładowy kod, którego można użyć do połączenia usługi Azure File Storage z innymi usługami w chmurze przy użyciu łącznika usług. Nadal możesz nawiązać połączenie z usługą Azure File Storage w innych językach programowania bez używania łącznika usługi. Na tej stronie są również wyświetlane domyślne nazwy zmiennych środowiskowych i wartości (lub konfiguracja platformy Spring Boot) podczas tworzenia połączenia z usługą.

Obsługiwane usługi obliczeniowe

Łącznik usługi może służyć do łączenia następujących usług obliczeniowych z usługą Azure Files:

• Azure App Service
• Azure Container Apps
• Azure Functions
• Azure Kubernetes Service (AKS)
• Azure Spring Apps

Obsługiwane typy uwierzytelniania i typy klientów

W poniższej tabeli pokazano, które kombinacje metod uwierzytelniania i klientów są obsługiwane do łączenia usługi obliczeniowej z usługą Azure Files przy użyciu łącznika usługi Service Connector. Wartość "Tak" wskazuje, że kombinacja jest obsługiwana, a wartość "Nie" wskazuje, że nie jest obsługiwana.

Typ klienta	Tożsamość zarządzana przypisana przez system	Tożsamość zarządzana przypisana przez użytkownika	Wpis tajny/parametry połączenia	Jednostka usługi
.NET	Nie	Nie.	Tak	Nie.
Java	Nie	Nie.	Tak	Nie.
Java — Spring Boot	Nie	Nie.	Tak	Nie.
Node.js	Nie	Nie.	Tak	Nie.
Python	Nie	Nie.	Tak	Nie.
PHP	Nie	Nie.	Tak	Nie.
Ruby	Nie	Nie.	Tak	Nie.
Brak	Nie	Nie.	Tak	Nie.

Ta tabela wskazuje, że jedyną obsługiwaną metodą uwierzytelniania dla wszystkich typów klientów jest metoda Secret /parametry połączenia. Metody tożsamości zarządzanej przypisanej przez system, tożsamości zarządzanej przypisanej przez użytkownika i jednostki usługi nie są obsługiwane dla żadnego z typów klientów w celu nawiązania połączenia z usługą Azure Files.

Domyślne nazwy zmiennych środowiskowych lub właściwości aplikacji i przykładowy kod

Użyj poniższych szczegółów połączenia, aby połączyć usługi obliczeniowe z usługą Azure File Storage. Dla każdego z poniższych przykładów zastąp tekst zastępczy <account-name>, <account-key>i <storage-account-name> <storage-account-key> własną nazwą konta, kluczem konta, nazwą konta magazynu i kluczem konta magazynu. Aby uzyskać więcej informacji na temat konwencji nazewnictwa, zapoznaj się z artykułem Dotyczącym wewnętrznych łączników usług.

Connection string

Ostrzeżenie

Firma Microsoft zaleca korzystanie z najbezpieczniejszego dostępnego przepływu uwierzytelniania. Przepływ uwierzytelniania opisany w tej procedurze wymaga bardzo wysokiego poziomu zaufania w aplikacji i niesie ze sobą ryzyko, które nie występują w innych przepływach. Tego przepływu należy używać tylko wtedy, gdy inne bezpieczniejsze przepływy, takie jak tożsamości zarządzane, nie są opłacalne.

Typ klienta SpringBoot

Właściwości aplikacji	opis	Przykładowa wartość
azure.storage.account-name	Nazwa konta magazynu plików	<storage-account-name>
azure.storage.account-key	Klucz konta magazynu plików	<storage-account-key>
azure.storage.file-endpoint	Punkt końcowy magazynu plików	https://<storage-account-name>.file.core.windows.net/
spring.cloud.azure.storage.fileshare.account-name	Nazwa konta magazynu plików dla platformy Azure Spring Cloud w wersji nowszej niż 4.0	<storage-account-name>
spring.cloud.azure.storage.fileshare.account-key	Klucz konta magazynu plików dla platformy Azure Spring Cloud w wersji nowszej niż 4.0	<storage-account-key>
spring.cloud.azure.storage.fileshare.endpoint	Punkt końcowy magazynu plików dla platformy Azure Spring Cloud w wersji nowszej niż 4.0	https://<storage-account-name>.file.core.windows.net/

Inne typy klientów

Domyślna nazwa zmiennej środowiskowej	opis	Przykładowa wartość
AZURE_STORAGEFILE_CONNECTIONSTRING	Parametry połączenia magazynu plików	DefaultEndpointsProtocol=https;AccountName=<account-name>;AccountKey=<account-key>;EndpointSuffix=core.windows.net

Przykładowy kod

Zapoznaj się z poniższymi krokami i kodem, aby nawiązać połączenie z usługą Azure File Storage przy użyciu klucza konta.

.NET

1. Zainstaluj zależność.

   dotnet add package Azure.Storage.Files.Shares --version 12.16.0
   

2. Pobierz parametry połączenia ze zmiennej środowiskowej dodanej przez łącznik usługi.

   using System;
   using Azure.Storage.Files.Shares;
   using Azure.Storage.Files.Shares.Models;
   
   var connectionString = Environment.GetEnvironmentVariable("AZURE_STORAGEFILE_CONNECTIONSTRING");
   ShareServiceClient service = new ShareServiceClient(connectionString)
   

Java

1. Dodaj następującą zależność w pliku pom.xml :

   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-storage-file-share</artifactId>
       <version>12.20.1</version>
   </dependency>
   

2. Pobierz parametry połączenia ze zmiennej środowiskowej dodanej przez łącznik usługi.

   import com.azure.storage.file.share.*;
   
   String connectionString = System.getenv("AZURE_STORAGEFILE_CONNECTIONSTRING");
   ShareServiceClient fileServiceClient = new ShareServiceClientBuilder()
       .connectionString(CONNECTION_STRING).buildClient();
   

SpringBoot

Zapoznaj się z przykładowym plikiem magazynu, aby skonfigurować aplikację Spring. Dwa zestawy właściwości konfiguracji są udostępniane zgodnie z wersją platformy Azure Spring Cloud (poniżej wersji 4.0 i nowszej 4.0). Aby uzyskać więcej informacji, zobacz Właściwości udziału plików usługi Azure Storage.

Python

1. Zainstaluj zależność.

   pip install azure-storage-file-share
   

2. Pobierz parametry połączenia ze zmiennej środowiskowej dodanej przez łącznik usługi.

   from azure.storage.fileshare import ShareServiceClient
   
   connection_string = os.getenv('AZURE_STORAGEFILE_CONNECTIONSTRING')
   service_client = ShareServiceClient.from_connection_string(connection_string)
   

NodeJS

1. Zainstaluj zależność.

   npm install @azure/storage-file-share
   

2. Pobierz parametry połączenia ze zmiennej środowiskowej dodanej przez łącznik usługi.

   const { ShareServiceClient } = require("@azure/storage-file-share");
   
   const connection_string = process.env.AZURE_STORAGEFILE_CONNECTIONSTRING;
   const shareServiceClient = ShareServiceClient.fromConnectionString(connection_string);
   

Inne

W przypadku innych języków można użyć informacji o połączeniu, które łącznik usługi ustawia na zmienne środowiskowe w celu nawiązania połączenia z usługą Azure File Storage. Aby uzyskać szczegółowe informacje o zmiennej środowiskowej, zobacz Integrowanie usługi Azure Files z łącznikiem usługi.

Następne kroki

Postępuj zgodnie z samouczkami wymienionymi poniżej, aby dowiedzieć się więcej o łączniku usługi.

Dowiedz się więcej o pojęciach dotyczących łącznika usług