Fraud Detection:Intégration du SDK de détection de fraude sur appareil pour HarmonyOS

{
  "dependencies": {
    "aliyundevice": "file:../libs/HarmonyOS-AliyunDevice-xxx.har"
  }
}

1. Initialisation (initWithOptions)

Cette fonction initialise le SDK et collecte les informations relatives à l'appareil. Appelez-la aussi tôt que possible lors du démarrage de l'application, tout en respectant les exigences de conformité. Effectuez cet appel une seule fois par lancement de l'application.

• Prototype de la fonction

export class SecurityInitListener {
  // code indicates the API call status code
  onInitFinish(code: number): void {}
}

public initWithOptions(ctx: Context,
                userAppKey: string,
                options: Map<string, string>,
                securityInitListener: SecurityInitListener): void;

• Paramètres

  • ctx : le contexte (Context) de l'Ability actuelle.

  • userAppKey : identifie votre application. Vous pouvez en faire la demande via la section Gestion des applications d'appareil de la console Alibaba Cloud.

  • securityInitListener : le rappel d'initialisation. Utilisez ce rappel pour vérifier si l'initialisation a réussi. Valeur par défaut : null. Pour connaître les valeurs valides du champ code, reportez-vous aux valeurs de retour d'état.

  • options : paramètres optionnels de collecte d'informations. Valeur par défaut : null. Les options disponibles sont les suivantes.

    Champ	Description	Exemple
    IPv6	Indique s'il faut utiliser un nom de domaine IPv6 pour signaler les informations de l'appareil. 0 (par défaut) : utiliser un nom de domaine IPv4. 1 : utiliser un nom de domaine IPv6.	"0"
    CustomUrl	Nom de domaine du serveur de rapport de données. Utilisé pour le rapport spécifique à un site. Aucune configuration n'est requise par défaut.	"https://cloudauth-device.aliyuncs.com"
    CustomHost	Hôte du serveur de rapport de données. Doit être utilisé conjointement avec CustomUrl. Aucun paramétrage n'est nécessaire par défaut.	"cloudauth-device.aliyuncs.com"

    Description des paramètres CustomUrl et CustomHost

    Pour le rapport spécifique à un site, définissez CustomUrl et CustomHost sur le point de terminaison désigné pour votre région. Aucune configuration n'est requise par défaut.

    Région	Adresse
    Singapour (par défaut)	CustomUrl : https://cloudauth-device.ap-southeast-1.aliyuncs.com CustomHost : cloudauth-device.ap-southeast-1.aliyuncs.com
    Chine (Hong Kong)	CustomUrl : https://cloudauth-device.cn-hongkong.aliyuncs.com CustomHost : cloudauth-device.cn-hongkong.aliyuncs.com
    Allemagne	CustomUrl : https://cloudauth-device.eu-central-1.aliyuncs.com CustomHost : cloudauth-device.eu-central-1.aliyuncs.com
    États-Unis	CustomUrl : https://cloudauth-device.us-west-1.aliyuncs.com CustomHost : cloudauth-device.us-west-1.aliyuncs.com

• Exemple

@State USER_PRODUCT_KEY: string = "123e4567e89b12d3a45642661417****";

let options: Map<string, string> = new Map<string, string>();
options.set("IPv6", "0"); // Set to IPv4
// Set a custom data reporting endpoint
// options.set("CustomUrl", "xxx"); Set the reporting site URL
// options.set("CustomHost", "xxx"); Set the reporting site host

SecurityDevice.getInstance().initWithOptions(getContext(),
                            this.USER_PRODUCT_KEY, options, null);

2. Obtention du jeton client (getDeviceToken)

Obtenez le jeton client et signalez-le à votre serveur métier. Vous pouvez ensuite utiliser l'intégration Intégration de l'API côté serveur côté serveur pour récupérer les informations sur les risques liés à l'appareil.

• Prototype de la fonction

export class SecurityToken {
   // Result code
  public code:number = 0;

  // deviceToken returned by the SDK
  public token:string = "";
}

// Recommended: pass bizId
public getDeviceToken(bizId?: string): SecurityToken

• Exemple

// Example with bizId. bizId is the client's business ID; passing it is optional.
let bizId = "1234567890abcdef1234567890ab****";
let tokenObj: SecurityToken = SecurityDevice.getInstance().getDeviceToken(bizId);
if (tokenObj.code == SecurityCode.SC_SUCCESS) {
  console.log("Aliyun Token: " + tokenObj.token);
} else {
  console.log("Aliyun Code: " + tokenObj.code);
}

3. Envoi du jeton à votre serveur métier

Après avoir obtenu le deviceToken, transmettez-le en tant que paramètre à votre serveur métier. Le serveur appelle ensuite l'API Alibaba Cloud de détection des risques liés aux appareils avec le deviceToken pour interroger et vérifier les informations sur les risques de l'appareil.

import { SecurityCode, SecurityToken, SecurityDevice } from 'aliyundevice';

@Entry
@Component
struct Index {
  @State message: string = 'Aliyun Device';
  @State ALIYUN_APPKEY: string = "XXX";

  build() {
    Row() {
      Column() {
        Button(this.message)
          .fontSize(18)
          .fontWeight(FontWeight.Bold)
          .onClick((event: ClickEvent) => {
            // Initialize the SDK. Call only once during the app lifecycle.
            SecurityDevice.getInstance().initWithOptions(getContext(), this.ALIYUN_APPKEY, null, null);

            // Do not call getDeviceToken synchronously right after initialization. If initialization has not finished, a degraded deviceToken is returned.
            setTimeout(() => {
              let tokenObj: SecurityToken = SecurityDevice.getInstance().getDeviceToken();
              if (tokenObj.code == SecurityCode.SC_SUCCESS) {
                console.log("Aliyun Token: " + tokenObj.token);
              } else {
                console.log("Aliyun Code: " + tokenObj.code);
              }
            }, 2000);
          })
          .margin({ top: 10 })
      }
      .width('100%')
    }
    .height('100%')
  }
}