Fraud Detection:Device Risk SDK iOS Integration

1. Initialisation (initDevice)

Cette fonction initialise le SDK et collecte les informations. Appelez cette fonction aussi tôt que possible dans les scénarios de détection des risques, à condition de respecter les exigences de conformité. Vous n'avez besoin d'appeler cette fonction qu'une seule fois par lancement de l'application.

• Prototype de la fonction

@interface SecurityDevice : NSObject
/**
 * Initialize the device fingerprint SDK.
 */
- (void)initDevice:(NSString *)userAppKey :(void (^)(int))initCallback;

/**
 * Initialize the SDK with options.
 */
- (void)initDevice:(NSString *)userAppKey withOptions:(NSMutableDictionary *)options callback:(void (^)(int))initCallback;

@end

Paramètres

• userAppKey : identifie votre application. Vous pouvez demander l'AppKey dans la section Gestion des applications Device de la console Alibaba Cloud Management Console.

• initCallback : écouteur de rappel d'initialisation. Utilisez ce rappel pour vérifier si l'initialisation a réussi. Valeur par défaut : nil. Pour connaître les valeurs valides du champ code, consultez les Valeurs de retour d'état.

• options : paramètres optionnels de collecte d'informations. Valeur par défaut : nil. Le tableau suivant décrit les options disponibles.

Paramètre DataType

Paramètres CustomUrl et CustomHost

Pour signaler des données à un site spécifique, définissez CustomUrl et CustomHost sur une région spécifique. Par défaut, il n'est pas nécessaire de configurer ces paramètres.

• Exemple

NSMutableDictionary *options = [[NSMutableDictionary alloc] init];
[options setValue:@"0" forKey:@"IPv6"];       // Use IPv4
// Specify a custom region to which data is reported
// [options setValue:@"xxx" forKey:@"CustomUrl"];  Set the reporting URL
// [options setValue:@"xxx" forKey:@"CustomHost"]; Set the reporting host

// Standard call (recommended)
[[SecurityDevice sharedInstance] initDevice:@"<your AppKey>" withOptions:options callback:nil];

// Call with a callback
[[SecurityDevice sharedInstance] initDevice:@"<your AppKey>" withOptions:options callback:^(int code) {
    NSString * initResult = [NSString stringWithFormat: @"Initialization result: %d", code];
    NSLog(@"%@", initResult);

    if (SC_SUCCESS != code) {
        NSLog(@"Initialization failed");
    } else {
        NSLog(@"Initialization succeeded");
    }
}];

2. Obtention du jeton client (getDeviceToken)

Obtenez le jeton client et signalez-le à votre serveur métier. Le serveur appelle ensuite l'API de détection de fraude pour interroger les informations sur les risques liés à l'appareil.

• Assurez-vous que l'intervalle entre l'appel à initDevice et l'appel à getDeviceToken est d'au moins 3 secondes, ou appelez getDeviceToken dans le rappel indiquant une initialisation réussie.

• (Recommandé) Spécifiez le paramètre bizId lors de l'appel à getDeviceToken. Cela lie le jeton à un ID métier unique. Transmettez le même ID lors de l'interrogation du résultat sur le serveur pour vérifier que le jeton n'a pas été altéré.

• (Recommandé) Appelez getDeviceToken sur un thread secondaire de l'application afin d'éviter les plantages qu'un appel de longue durée pourrait provoquer.

• Prototype de la fonction

@interface SecurityDevice : NSObject
- (SecurityToken *)getDeviceToken;
- (SecurityToken *)getDeviceToken:(NSString *)bizId;
@end

• Exemple

// Specify bizId to prevent deviceToken from being tampered with. Replace the example value with your business ID.
NSString *bizId = @"1234567890abcdef******";
SecurityToken *deviceToken = [[SecurityDevice sharedInstance] getDeviceToken:bizId];

if (deviceToken == nil || SC_SUCCESS != deviceToken.code) {
    NSLog(@"Failed to obtain the token. Code: %d", deviceToken.code);
} else {
    NSLog(@"The token is obtained. You can query risk tags. Token: %@", deviceToken.token);
}

Transmettez deviceToken conjointement avec d'autres paramètres à l'API de détection de fraude, comme décrit dans les Paramètres d'événement Device Fraud Detection.

3. Envoi du jeton à votre serveur métier

Une fois que vous avez obtenu le deviceToken, transmettez-le en tant que paramètre à votre serveur métier. Le serveur appelle l'API Alibaba Cloud Device Fraud Detection avec le deviceToken pour interroger et vérifier les informations sur les risques liés à l'appareil.

static NSString *USER_APP_KEY = @"<Obtain the AppKey in the console>";

- (void)viewDidLoad {
    [super viewDidLoad];

    // Integration example
    [self doStandard];
}

- (void)doStandard {
    // Initialize the SDK
    // You need to call this method only once in the app lifecycle
    [self doInit];

    dispatch_async(dispatch_get_global_queue(NULL, NULL), ^{
        // This delay is for demonstration only. No sleep is needed in production.
        [NSThread sleepForTimeInterval:2.0];

        // Obtain the token
        [self doGetToken];
    });
}

- (void)doInit {
    NSMutableDictionary *options = [[NSMutableDictionary alloc] init];
    [options setValue:@"0" forKey:@"IPv6"];         // Use IPv4
    // Specify a custom region to which data is reported
    // [options setValue:@"https://cloudauth-device.aliyuncs.com" forKey:@"CustomUrl"];
    // [options setValue:@"cloudauth-device.aliyuncs.com" forKey:@"CustomHost"];
    [[SecurityDevice sharedInstance] initDevice:USER_APP_KEY withOptions:options callback:nil];
}

- (void)doGetToken {
    // Specify bizId to prevent deviceToken from being tampered with. Replace the example value with your business ID.
    NSString *bizId = @"1234567890abcdef******";
    SecurityToken *deviceToken = [[SecurityDevice sharedInstance] getDeviceToken:bizId];

    if (deviceToken == nil || SC_SUCCESS != deviceToken.code) {
        NSLog(@"Failed to obtain the token. The result cannot be used to query risk tags.");
    } else {
        NSLog(@"The token is obtained. You can query risk tags. Token: %@", deviceToken.token);
    }
}