Object Storage Service:Accéder à OSS via un réseau privé en utilisant PrivateLink

Étape 1 : Créer un endpoint

1. Accédez à la page Endpoint VPC et cliquez sur Create Endpoint. S'il s'agit de votre première utilisation, suivez les instructions à l'écran pour activer le service PrivateLink.

2. Configurez les paramètres suivants. Vous pouvez laisser les autres paramètres à leurs valeurs par défaut.

   • Region : sélectionnez la région où se trouve le bucket OSS cible, par exemple Chine (Hangzhou).

   • Endpoint Name : saisissez un nom descriptif pour l'endpoint, par exemple privatelink-oss.

   • Endpoint Type : sélectionnez Interface Endpoint.

   • Endpoint Service : sélectionnez Alibaba Cloud Service, puis sélectionnez le service d'endpoint OSS dans la liste des services. Le nom du service se termine par oss.

     Remarque

     Si le service d'endpoint OSS n'apparaît pas dans la liste des services, contactez le support technique pour demander l'activation.

   • VPC : sélectionnez le VPC cible dans lequel vous souhaitez créer l'endpoint. Si aucun VPC n'est disponible, cliquez sur Create VPC pour en créer un.

   • Security Groups : sélectionnez le groupe de sécurité à associer à l'endpoint pour le contrôle d'accès. Si aucun groupe de sécurité approprié n'existe, cliquez sur Create Security Group pour en créer un.

   • Zone and vSwitch : sélectionnez la zone de disponibilité et le vSwitch correspondant où vous souhaitez déployer l'endpoint. Si aucun vSwitch n'est disponible, cliquez sur Create vSwitch pour en créer un.

3. Cliquez sur OK. Le système crée automatiquement l'endpoint. Une fois l'endpoint créé, accédez à la page des détails de l'endpoint pour afficher et copier le Domain Name of Endpoint Service, que vous utiliserez pour accéder à OSS.

   

Étape 2 : Vérifier l'endpoint

Exécutez un test de connectivité et téléchargez un fichier pour confirmer que l'endpoint PrivateLink est fonctionnel.

• Vérifier la connectivité réseau

  Utilisez la commande ping pour tester le nom de domaine de l'endpoint et confirmer que la résolution DNS et le chemin réseau fonctionnent.

  ping -c 4 ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com

• Vérifier le téléchargement de fichier

  Depuis une instance ECS située dans la même région, utilisez ossutil pour télécharger un fichier depuis OSS. Cela permet de vérifier la fonctionnalité de bout en bout de la connexion PrivateLink.

  1. Installer et configurer ossutil 2,0.

  2. Utilisez le nom de domaine de l'endpoint (par exemple, ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com) pour accéder aux ressources OSS. L'exemple suivant télécharge un fichier nommé dest.jpg depuis un bucket nommé example-bucket :

     ossutil cp oss://example-bucket/dest.jpg /tmp/ -e ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com --addressing-style path

     Une exécution réussie de la commande renvoie la sortie suivante, indiquant que le fichier est téléchargé. Vous pouvez consulter le fichier téléchargé dans le répertoire /tmp.

     Success: Total 1 object, size 134102 B, Download done:(1 files, 134102 B), avg 680.112 KiB/s
     
     0.193189(s) elapsed

Étape 1 : Créer une passerelle SSL-VPN et configurer le client

Déployez une passerelle SSL-VPN et configurez le client pour établir une connexion chiffrée entre votre appareil local et le VPC. Pour les étapes détaillées, consultez Connecter un PC ou un client Android à un VPC à l'aide d'une connexion SSL-VPN.

Étape 2 : Vérifier l'accès privé à OSS

Exécutez un test de connectivité et téléchargez un fichier pour confirmer que la connexion PrivateLink depuis l'appareil local est fonctionnelle.

• Vérifier la connectivité

  Utilisez la commande ping pour tester le nom de domaine de l'endpoint et confirmer que la résolution DNS et le chemin réseau fonctionnent.

  ping -c 4 ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com

• Vérifier le téléchargement de fichier

  ossutil

  Utilisez ossutil pour effectuer une opération sur un fichier afin de vérifier la fonctionnalité de la connexion PrivateLink.

  1. Installer et configurer ossutil 2,0.

  2. Utilisez le nom de domaine de l'endpoint (par exemple, ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com) pour accéder aux ressources OSS. L'exemple suivant télécharge un fichier nommé dest.jpg depuis un bucket nommé example-bucket :

     ossutil cp oss://example-bucket/dest.jpg /tmp/ -e ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com --addressing-style path

     Une exécution réussie de la commande renvoie la sortie suivante, indiquant que le fichier est téléchargé. Vous pouvez consulter le fichier téléchargé dans le répertoire /tmp.

     Success: Total 1 object, size 134102 B, Download done:(1 files, 134102 B), avg 680.112 KiB/s
     
     0.193189(s) elapsed

  SDK

  L'utilisation d'un SDK est plus représentative des environnements de production car elle permet une logique métier complexe et une gestion des exceptions.

  Java

  Lorsque vous accédez à OSS via PrivateLink, appelez setSLDEnabled(true) pour activer l'accès de type path-style. Pour l'accès via l'internet public, définissez ce paramètre sur setSLDEnabled(false).

  import com.aliyun.oss.*;
  import com.aliyun.oss.common.auth.*;
  import com.aliyun.oss.common.comm.SignVersion;
  import com.aliyun.oss.model.GetObjectRequest;
  import java.io.File;
  
  /**
   * OSS PrivateLink access example
   * Demonstrates how to access OSS and download a file by using PrivateLink.
   */
  public class Test {
  
      public static void main(String[] args) throws Exception {
          // The PrivateLink endpoint domain.
          String endpoint = "https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com";
  
          // Specify the region that corresponds to the endpoint. For example, cn-hangzhou.
          String region = "cn-hangzhou";
  
          // Obtain credentials from environment variables.
          // Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
          EnvironmentVariableCredentialsProvider credentialsProvider =
                  CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
  
          // Specify the bucket name. For example, example-bucket.
          String bucketName = "example-bucket";
  
          // Specify the full path of the object. Do not include the bucket name in the full path.
          String objectName = "dest.jpg";
  
          // Specify the local path to save the downloaded file.
          String pathName = "dest.jpg";
  
          // Configure client parameters.
          ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
  
          // Enable path-style access for PrivateLink. Set this parameter to false for public internet access through the bucket's public domain name.
          clientBuilderConfiguration.setSLDEnabled(true);
  
          // Explicitly use Signature Version 4.
          clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
  
          // Create an OSS client instance.
          OSS ossClient = OSSClientBuilder.create()
                  .endpoint(endpoint)
                  .credentialsProvider(credentialsProvider)
                  .clientConfiguration(clientBuilderConfiguration)
                  .region(region)
                  .build();
  
          try {
              // Download the object to a local file.
              // If the specified local file exists, it is overwritten. If it does not exist, it is created.
              // If you do not specify a local path, the file is downloaded to the project's root directory.
              ossClient.getObject(new GetObjectRequest(bucketName, objectName), new File(pathName));
  
          } catch (OSSException oe) {
              // Handle OSS server-side exceptions.
              System.out.println("Caught an OSSException, which means your request made it to the OSS server, but was rejected with an error response.");
              System.out.println("Error Message: " + oe.getErrorMessage());
              System.out.println("Error Code: " + oe.getErrorCode());
              System.out.println("Request ID: " + oe.getRequestId());
              System.out.println("Host ID: " + oe.getHostId());
  
          } catch (ClientException ce) {
              // Handle client-side exceptions.
              System.out.println("Caught a ClientException, which means the client encountered a serious internal problem while trying to communicate with OSS, " +
                      "such as not being able to access the network.");
              System.out.println("Error Message: " + ce.getMessage());
  
          } finally {
              // Release resources.
              if (ossClient != null) {
                  ossClient.shutdown();
              }
          }
      }
  }

  Python

  Lorsque vous accédez à OSS via PrivateLink, définissez is_path_style=True pour activer l'accès de type path-style.

  # -*- coding: utf-8 -*-
  """
  OSS PrivateLink access example
  This sample shows how to access OSS and download a file to a local path over a PrivateLink connection.
  """
  
  import oss2
  from oss2.credentials import EnvironmentVariableCredentialsProvider
  
  def main():
      """Main function: Demonstrates how to access OSS and download a file by using PrivateLink."""
      
      # Configure credentials.
      # An Alibaba Cloud account AccessKey pair has full permissions on all API operations. Using these credentials poses a high security risk.
      # We strongly recommend that you create and use a RAM user to call API operations or perform routine O&M.
      auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
      
      # The PrivateLink endpoint domain.
      endpoint = 'https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com'
      
      # The bucket name.
      bucket_name = 'example-bucket'
      
      # Create a Bucket object.
      # Set is_path_style=True to enable path-style access, which is required for scenarios like PrivateLink.
      bucket = oss2.Bucket(auth, endpoint, bucket_name, is_path_style=True)
      
      # The path of the OSS object. Do not include the bucket name in the path.
      object_name = 'dest.jpg'
      
      # The local path to save the downloaded file.
      local_file_path = 'dest.jpg'
      
      # Download the object to a local file.
      # If the specified local file exists, it is overwritten. If it does not exist, it is created.
      bucket.get_object_to_file(object_name, local_file_path)
      
      print(f"File downloaded successfully: {object_name} -> {local_file_path}")
  
  if __name__ == '__main__':
      main()      

  Go

  Lorsque vous accédez à OSS via PrivateLink, utilisez ForcePathStyle(true) pour activer l'accès de type path-style.

  package main
  
  import (
  	"fmt"
  	"os"
  
  	"github.com/aliyun/aliyun-oss-go-sdk/oss"
  )
  
  const (
  	// The PrivateLink endpoint domain.
  	endpoint = "https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com"
  
  	// The bucket name.
  	bucketName = "example-bucket"
  
  	// The path of the OSS object. Do not include the bucket name in the path.
  	objectName = "dest.jpg"
  
  	// The local path to save the downloaded file.
  	localFilePath = "dest.jpg"
  )
  
  func main() {
  	// Initialize the credentials provider.
  	// Obtain credentials from environment variables.
  	// Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
  	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
  	if err != nil {
  		fmt.Printf("Failed to initialize the credentials provider: %v\n", err)
  		os.Exit(-1)
  	}
  
  	// Create an OSS client instance.
  	// Use oss.ForcePathStyle(true) to enable path-style access, which is required for scenarios like PrivateLink.
  	client, err := oss.New(
  		endpoint,
  		"", // The AccessKey ID is obtained from the provider and can be left empty here.
  		"", // The AccessKey secret is obtained from the provider and can be left empty here.
  		oss.SetCredentialsProvider(&provider),
  		oss.ForcePathStyle(true),
  	)
  	if err != nil {
  		fmt.Printf("Failed to create the OSS client: %v\n", err)
  		os.Exit(-1)
  	}
  
  	// Obtain the bucket object.
  	bucket, err := client.Bucket(bucketName)
  	if err != nil {
  		fmt.Printf("Failed to obtain the bucket object: %v\n", err)
  		os.Exit(-1)
  	}
  
  	// Download the object to a local file.
  	// If the specified local file exists, it is overwritten. If it does not exist, it is created.
  	// If you do not specify a local path, the file is downloaded to the project's root directory.
  	err = bucket.GetObjectToFile(objectName, localFilePath)
  	if err != nil {
  		fmt.Printf("Failed to download the file: %v\n", err)
  		os.Exit(-1)
  	}
  
  	fmt.Printf("File downloaded successfully: %s -> %s\n", objectName, localFilePath)
  }
  

  C++

  Lorsque vous accédez à OSS via PrivateLink, définissez conf.isPathStyle = true pour activer l'accès de type path-style.

  #include <alibabacloud/oss/OssClient.h>
  #include <memory>
  #include <fstream>
  #include <iostream>
  
  using namespace AlibabaCloud::OSS;
  
  int main(void)
  {
      // The PrivateLink endpoint domain.
      std::string Endpoint = "https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com";
      
      // The bucket name.
      std::string BucketName = "example-bucket";
      
      // The path of the OSS object. Do not include the bucket name in the path.
      std::string ObjectName = "dest.jpg";
      
      // The local path to save the downloaded file.
      // If the specified local file exists, it is overwritten. If it does not exist, it is created.
      // If you do not specify a local path, the file is downloaded to the project's root directory.
      std::string FileNametoSave = "dest.jpg";
  
      // Initialize OSS SDK resources.
      InitializeSdk();
  
      // Configure client parameters.
      ClientConfiguration conf;
      
      // Obtain credentials from environment variables.
      // Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
      auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
      
      // Enable path-style access, which is required for scenarios like PrivateLink.
      conf.isPathStyle = true;
      
      // Create an OSS client instance.
      OssClient client(Endpoint, credentialsProvider, conf);
  
      // Build a request to download the object.
      GetObjectRequest request(BucketName, ObjectName);
      
      // Set a response stream factory to create a local file stream.
      request.setResponseStreamFactory([=]() {
          return std::make_shared<std::fstream>(
              FileNametoSave, 
              std::ios_base::out | std::ios_base::in | std::ios_base::trunc | std::ios_base::binary
          );
      });
  
      // Execute the download operation.
      auto outcome = client.GetObject(request);
  
      // Handle the download result.
      if (outcome.isSuccess()) {
          std::cout << "File downloaded successfully. Size: " 
                    << outcome.result().Metadata().ContentLength() 
                    << " bytes" << std::endl;
          std::cout << "Saved to: " << FileNametoSave << std::endl;
      }
      else {
          // Handle errors.
          std::cout << "Download failed" << std::endl
                    << "Error code: " << outcome.error().Code() << std::endl
                    << "Error message: " << outcome.error().Message() << std::endl
                    << "Request ID: " << outcome.error().RequestId() << std::endl;
          
          // Release resources and return an error code.
          ShutdownSdk();
          return -1;
      }
  
      // Release OSS SDK resources.
      ShutdownSdk();
      return 0;
  }