Object Storage Service:Authorize access (iOS SDK)

Notas

Cuando utilice el modo de autenticación STS o el modo autofirmado, asegúrese de que la función de callback que emplee pueda devolver el token de seguridad y la firma. Si necesita obtener el token y la firma del servidor de aplicaciones mediante una solicitud dentro de la función de callback, se recomienda llamar a las operaciones síncronas de la API incluidas en la biblioteca de red. La función de callback se ejecuta en el hilo secundario de la solicitud generada por el SDK y no bloquea el hilo principal.

Modo de autenticación STS

Para acceder a OSS con credenciales de acceso temporal proporcionadas por STS, realice las siguientes operaciones:

1. Obtenga credenciales de acceso temporal.

   Las credenciales de acceso temporal contienen un token de seguridad y un par de AccessKey temporal. Un par de AccessKey consta de un AccessKey ID y un AccessKey secret. El periodo de validez mínimo de las credenciales de acceso temporal es de 900 segundos. El periodo de validez máximo corresponde a la duración máxima de sesión especificada para el rol actual. Para obtener más información, consulte Specify the maximum session duration for a RAM role.

   Puede utilizar uno de los siguientes métodos para obtener credenciales de acceso temporal:

   • Método 1

     Llame a la operación AssumeRole.

   • Método 2

     Puede obtener credenciales de acceso temporal mediante STS SDKs for various languages.

2. Utilice las credenciales de acceso temporal para inicializar el SDK de OSS para iOS.

   id<OSSCredentialProvider> credential = [[OSSStsTokenCredentialProvider alloc] initWithAccessKeyId:@"<StsToken.AccessKeyId>" secretKeyId:@"<StsToken.SecretKeyId>" securityToken:@"<StsToken.SecurityToken>"];
   client = [[OSSClient alloc] initWithEndpoint:endpoint credentialProvider:credential];

   Nota

   Puede usar OSSAuthCredentialProvider para inicializar el SDK de OSS para iOS. Para obtener más información, consulte Initialization.

   Al inicializar el SDK con credenciales de acceso temporal, tenga en cuenta el periodo de validez del token STS. El siguiente código de ejemplo muestra cómo determinar dicho periodo de validez:

   NSDateFormatter * fm = [NSDateFormatter new];
   fm.locale = [NSLocale localeWithLocaleIdentifier:@"en_US_POSIX"];
   [fm setDateFormat:@"yyyy-MM-dd'T'HH:mm:ssZ"];
   NSDate *expirationDate = [fm dateFromString:@"<StsToken.Expiration>"];
   NSTimeInterval interval = [expirationDate timeIntervalSinceDate:[NSDate date]];
   // The STS token is about to expire within less than five minutes. 
   if (interval < 5 * 60) {
       id<OSSCredentialProvider> credential = [[OSSStsTokenCredentialProvider alloc] initWithAccessKeyId:@"<StsToken.AccessKeyId>" secretKeyId:@"<StsToken.SecretKeyId>" securityToken:@"<StsToken.SecurityToken>"];
       client = [[OSSClient alloc] initWithEndpoint:endpoint credentialProvider:credential];
   }

   • Actualice manualmente el token STS

     Cuando el token STS esté próximo a caducar, puede crear una nueva instancia de OSSClient o actualizar CredentialProvider mediante el siguiente método:

     id<OSSCredentialProvider> credential = [[OSSStsTokenCredentialProvider alloc] initWithAccessKeyId:@"<StsToken.AccessKeyId>" secretKeyId:@"<StsToken.SecretKeyId>" securityToken:@"<StsToken.SecurityToken>"];
     client = [[OSSClient alloc] initWithEndpoint:endpoint credentialProvider:credential];

   • Actualice automáticamente el token STS

     Si desea que el SDK actualice automáticamente el token STS, debe implementar un callback en su aplicación. Este callback obtiene un token de federación (token STS) y lo devuelve al SDK, el cual lo utiliza para generar firmas. Cuando sea necesario renovar el token STS, el SDK invocará el callback para obtener uno nuevo.

     id<OSSCredentialProvider> credential = [[OSSFederationCredentialProvider alloc] initWithFederationTokenGetter:^OSSFederationToken * {
         // Implement a function that obtains a federation token and returns it as an OSSFederationToken object. 
         // If the federation token is not obtained, nil is returned. 
           OSSFederationToken * token;
         // Obtain a federation token from your server. 
         ...
         return token;
     }];
     client = [[OSSClient alloc] initWithEndpoint:endpoint credentialProvider:credential];

     Nota

     Si obtiene todos los campos necesarios para generar un token STS por otros medios, puede devolver el token directamente en el callback. En este caso, deberá actualizar manualmente el token y luego reconfigurar OSSCredentialProvider de la instancia OSSClient.

     Si la URL del servidor desde el que solicita un token es http://localhost:8080/distribute-token.json, se devolverá la siguiente respuesta de ejemplo:

     {
         "StatusCode": 200,
         "AccessKeyId":"STS.iA645eTOXEqP3cg3****",
         "AccessKeySecret":"rV3VQrpFQ4BsyHSAvi5NVLpPIVffDJv4LojU****",
         "Expiration":"2015-11-03T09:52:59Z",
         "SecurityToken":"CAES7QIIARKAAZPlqaN9ILiQZPS+JDkS/GSZN45RLx4YS/p3OgaUC+oJl3XSlbJ7StKpQ****"
     }                           

     El siguiente código de ejemplo muestra cómo implementar OSSFederationCredentialProvider:

     id<OSSCredentialProvider> credential2 = [[OSSFederationCredentialProvider alloc] initWithFederationTokenGetter:^OSSFederationToken * {
         // Create a request to access your application server. 
         NSURL * url = [NSURL URLWithString:@"http://localhost:8080/distribute-token.json"];
         // Use a request to set the parameters required by your server. 
         NSURLRequest * request = [NSURLRequest requestWithURL:url];
         OSSTaskCompletionSource * tcs = [OSSTaskCompletionSource taskCompletionSource];
         NSURLSession * session = [NSURLSession sharedSession];
         // Send the request. 
         NSURLSessionTask * sessionTask = [session dataTaskWithRequest:request
                                                     completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
                                                         if (error) {
                                                             [tcs setError:error];
                                                             return;
                                                         }
                                                         [tcs setResult:data];
                                                     }];
         [sessionTask resume];
         // Wait until the response to the request is returned. 
         [tcs.task waitUntilFinished];
         // Parse the returned results. 
         if (tcs.task.error) {
             NSLog(@"get token error: %@", tcs.task.error);
             return nil;
         } else {
             // The returned data is in the JSON format. Parse the data to obtain the values of the fields of the token. 
             NSDictionary * object = [NSJSONSerialization JSONObjectWithData:tcs.task.result
                                                                     options:kNilOptions
                                                                       error:nil];
             OSSFederationToken * token = [OSSFederationToken new];
             token.tAccessKey = [object objectForKey:@"AccessKeyId"];
             token.tSecretKey = [object objectForKey:@"AccessKeySecret"];
             token.tToken = [object objectForKey:@"SecurityToken"];
             token.expirationTimeInGMTFormat = [object objectForKey:@"Expiration"];
             NSLog(@"get token: %@", token);
             return token;
         }
     }];

URL prefirmadas