Trasmissione delle informazioni del client (dispositivo, connessione e applicazione) pass-client-info

Ambito pass-client-info-scope

Questo documento aggrega i dettagli e i manuali per il passaggio di informazioni client (dispositivo, connessione e applicazione) da un’applicazione Programmatore alle API REST o agli SDK di autenticazione di Adobe Pass.

I vantaggi della fornitura di informazioni ai clienti sono:

Panoramica pass-client-info-overview

Le informazioni sul cliente sono costituite da:

Le informazioni client sono un oggetto JSON creato con le chiavi presentate nella tabella seguente.

Riferimenti API api-ref

Questa sezione descrive l’API responsabile della gestione delle informazioni client quando si utilizzano le API REST o gli SDK per l’autenticazione di Adobe Pass.

API REST rest-api

I servizi di autenticazione di Adobe Pass supportano la ricezione delle informazioni client nei modi seguenti:

SDK

SDK JavaScript js-sdk

L’SDK JavaScript di AccessEnabler crea per impostazione predefinita un oggetto JSON di informazioni client, che verrà passato ai servizi di autenticazione di Adobe Pass, a meno che non venga sostituito.

L’SDK JavaScript di AccessEnabler supporta solo sostituzione la chiave "applicationId" dall’oggetto JSON di informazioni client attraverso setRequestordi applicationId parametro options.

SDK per iOS/tvOS ios-tvos-sdk

L’SDK iOS/tvOS di AccessEnabler crea per impostazione predefinita un oggetto JSON di informazioni client, che verrà passato ai servizi di autenticazione di Adobe Pass, a meno che non venga sostituito.

L’SDK di AccessEnabler per iOS/tvOS supporta sovrascrittura di tutto informazioni client oggetto JSON tramite setOptionsparametro device_info di.

SDK per Android e FireOS and-fire-os-sdk

Il AccessEnabler L’SDK Android/FireOS crea per impostazione predefinita un oggetto JSON di informazioni client, che verrà passato ai servizi di autenticazione di Adobe Pass, a meno che non venga sostituito.

Il AccessEnabler L’SDK per Android/FireOS supporta sovrascrittura di tutto informazioni client oggetto JSON tramite setOptionss/setOptionsdi device_info parametro.

Cookbook cookbooks

Questa sezione presenta un manuale per la creazione dell’oggetto JSON delle informazioni client in caso di diversi tipi di dispositivi.

Android android

Le informazioni sul dispositivo possono essere costruite nel modo seguente:

Le informazioni di connessione possono essere costruite nel modo seguente:

Le informazioni sull'applicazione possono essere costruite nel modo seguente:

Codice di esempio

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

Le informazioni sul dispositivo possono essere costruite nel modo seguente:

Le informazioni di connessione possono essere costruite nel modo seguente:

Le informazioni sull'applicazione possono essere costruite nel modo seguente:

iOS/tvOS ios-tvos

Le informazioni sul dispositivo possono essere costruite nel modo seguente:

Le informazioni di connessione possono essere costruite nel modo seguente:

Le informazioni sull'applicazione possono essere costruite nel modo seguente:

Codice di esempio

+ (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

Le informazioni sul dispositivo possono essere costruite nel modo seguente:

Le informazioni di connessione possono essere costruite nel modo seguente:

Le informazioni sull'applicazione possono essere costruite nel modo seguente:

XBOX 1/360 xbox

Le informazioni sul dispositivo possono essere costruite nel modo seguente:

Le informazioni di connessione possono essere costruite nel modo seguente:

Le informazioni sull'applicazione possono essere costruite nel modo seguente:

Risorse