Pasar información del cliente (dispositivo, conexión y aplicación) pass-client-info

Ámbito pass-client-info-scope

Este documento agrega detalles y libros de cocina para pasar información del cliente (dispositivo, conexión y aplicación) desde una aplicación de programador a las API de REST de autenticación de Adobe Pass o a los SDK.

Las ventajas de proporcionar información al cliente son las siguientes:

Información general pass-client-info-overview

La información del cliente consta de:

La información del cliente es un objeto JSON creado con claves presentadas en la siguiente tabla.

Referencias de API api-ref

Esta sección presenta la API responsable de administrar la información del cliente cuando se utilizan las API de REST de autenticación de Adobe Pass o los SDK.

API DE REST rest-api

Los servicios de autenticación de Adobe Pass admiten la recepción de la información del cliente de las siguientes maneras:

SDK

SDK de JavaScript js-sdk

El SDK de JavaScript de AccessEnabler crea de forma predeterminada un objeto JSON de información del cliente, que se pasará a los servicios de autenticación de Adobe Pass, a menos que se anule.

El SDK de JavaScript de AccessEnabler admite anular solamente la clave "applicationId" del objeto JSON de información del cliente mediante el parámetro de opciones setRequestor applicationId.

SDK de iOS/tvOS ios-tvos-sdk

El SDK de AccessEnabler para iOS/tvOS crea de forma predeterminada un objeto JSON de información del cliente, que se pasará a los servicios de autenticación de Adobe Pass, a menos que se anule.

El SDK de AccessEnabler para iOS/tvOS admite que se anule todo el objeto JSON de información del cliente a través del parámetro device_info de setOptions.

SDK de Android/FireOS and-fire-os-sdk

El SDK de Android/FireOS AccessEnabler crea de forma predeterminada un objeto JSON de información de cliente, que se pasará a los servicios de autenticación de Adobe Pass, a menos que se anule.

El SDK de Android/FireOS AccessEnabler admite la anulación del objeto JSON de información de cliente completo a través del parámetro device_info de setOptions/setOptions.

Libros cookbooks

Esta sección presenta un libro de cocina para crear el objeto JSON de información del cliente en el caso de diferentes tipos de dispositivos.

Android android

La información del dispositivo se puede construir de la siguiente manera:

La información de conexión se puede construir de la siguiente manera:

La información de la aplicación se puede construir de la siguiente manera:

Código de muestra

private JSONObject computeClientInformation() {
     String LOGGING_TAG = "DefineClass.class";

     JSONObject clientInformation = new JSONObject();

     String connectionType;

     try {
          ConnectivityManager cm = (ConnectivityManager) getContext().getSystemService(CONNECTIVITY_SERVICE);
          NetworkInfo activeNetwork = cm.getActiveNetworkInfo();

          if (activeNetwork != null && activeNetwork.isConnectedOrConnecting()) {
              switch (activeNetwork.getType()) {
                    case ConnectivityManager.TYPE_WIFI: {
                        connectionType = "WIFI";
                        break;
                    }
                    case ConnectivityManager.TYPE_BLUETOOTH: {
                        connectionType = "BLUETOOTH";
                        break;
                    }
                    case ConnectivityManager.TYPE_MOBILE: {
                        connectionType = "MOBILE";
                        break;
                    }
                    case ConnectivityManager.TYPE_ETHERNET: {
                        connectionType = "ETHERNET";
                        break;
                    }
                    case ConnectivityManager.TYPE_VPN: {
                        connectionType = "VPN";
                        break;
                    }
                    case ConnectivityManager.TYPE_DUMMY: {
                        connectionType = "DUMMY";
                        break;
                    }
                    case ConnectivityManager.TYPE_MOBILE_DUN: {
                        connectionType = "MOBILE_DUN";
                        break;
                    }
                    case ConnectivityManager.TYPE_WIMAX: {
                        connectionType = "WIMAX";
                        break;
                    }
                    default:
                       connectionType = ConnectivityManager.EXTRA_OTHER_NETWORK_INFO;
              }
          } else {
                connectionType = ConnectivityManager.EXTRA_NO_CONNECTIVITY;
          }
     } catch (Exception e) {
          connectionType = "notAccessible";
     }

     try {
          clientInformation.put("model",Build.MODEL);
          clientInformation.put("vendor", Build.BRAND);
          clientInformation.put("manufacturer",Build.MANUFACTURER);
          clientInformation.put("version",Build.DEVICE);
          clientInformation.put("osName","Android");
          clientInformation.put("osVersion",Build.VERSION.RELEASE);
          clientInformation.put("connectionType",connectionType);
          clientInformation.put("applicationId","CNN");
     } catch (JSONException e) {
          Log.e(LOGGING_TAG, e.getMessage());
     }

     return Base64.encodeToString(clientInformation.toString().getBytes(), Base64.NO_WRAP);
}

FireTV fire-tv

La información del dispositivo se puede construir de la siguiente manera:

La información de conexión se puede construir de la siguiente manera:

La información de la aplicación se puede construir de la siguiente manera:

iOS/tvOS ios-tvos

La información del dispositivo se puede construir de la siguiente manera:

La información de conexión se puede construir de la siguiente manera:

La información de la aplicación se puede construir de la siguiente manera:

Código de muestra

+ (NSString *)computeClientInformation {
        struct utsname u;
        uname(&u);

        NSString *hardware = [NSString stringWithCString:u.machine encoding:NSUTF8StringEncoding];

        UIDevice *device = [UIDevice currentDevice];

        NSString *deviceType;

        switch (UI_USER_INTERFACE_IDIOM()) {
            case UIUserInterfaceIdiomPhone:
                deviceType = @"MobilePhone";
                break;
            case UIUserInterfaceIdiomPad:
                deviceType = @"Tablet";
                break;
            case UIUserInterfaceIdiomTV:
                deviceType = @"TV";
                break;
            default:
                deviceType = @"Unknown";
        }

        CGRect screenRect = [[UIScreen mainScreen] bounds];
        NSNumber *screenWidth = @((float) screenRect.size.width);
        NSNumber *screenHeight = @((float) screenRect.size.height);

        Reachability *reachability = [Reachability reachabilityForInternetConnection];
        [reachability startNotifier];

        NetworkStatus status = [reachability currentReachabilityStatus];

        NSString *connectionType;

        if (status == NotReachable) {
            connectionType = @"notConnected";
        } else if (status == ReachableViaWiFi) {
            connectionType = @"WiFi";
        } else if (status == ReachableViaWWAN) {
            connectionType = @"cellular";
        }

        NSMutableDictionary *clientInformation = [@{
                @"type": deviceType,
                @"model": device.model,
                @"vendor": @"Apple",
                @"manufacturer": @"Apple",
                @"version": [hardware stringByReplacingOccurrencesOfString:device.model withString:@""],
                @"osName": device.systemName,
                @"osVersion": device.systemVersion,
                @"displayWidth": screenWidth,
                @"displayHeight": screenHeight,
                @"connectionType": connectionType,
                @"applicationId": @"CNN"
        } mutableCopy];

        NSError *error;
        NSData *jsonData = [NSJSONSerialization dataWithJSONObject:clientInformation options:NSJSONWritingPrettyPrinted error:&error];
        NSString *base64Encoded = [jsonData base64EncodedStringWithOptions:0];

        return base64Encoded;
}

Roku roku

La información del dispositivo se puede construir de la siguiente manera:

La información de conexión se puede construir de la siguiente manera:

La información de la aplicación se puede construir de la siguiente manera:

XBOX 1/360 xbox

La información del dispositivo se puede construir de la siguiente manera:

La información de conexión se puede construir de la siguiente manera:

La información de la aplicación se puede construir de la siguiente manera:

Recursos