Cette rubrique décrit la procédure d'intégration du SDK Device Risk (mini-programme WeChat) afin d'incorporer le SDK aux applications nécessitant une protection.
Informations générales
Le SDK pour mini-programme WeChat est un outil d'identification des risques liés aux appareils, conçu spécifiquement pour l'environnement des mini-programmes. L'intégration de ce SDK permet aux développeurs de mettre rapidement en œuvre des fonctionnalités d'empreinte numérique des appareils, d'obtenir des informations sur l'appareil en temps réel et d'utiliser le service d'identification des risques. Le SDK prend en charge divers scénarios tels que l'inscription, la connexion et les campagnes marketing, offrant ainsi une défense efficace contre les activités frauduleuses et améliorant la sécurité métier.
Guide d'intégration du SDK
Téléchargement et importation du SDK pour mini-programme
Téléchargez le SDK pour mini-programme WeChat. Nous vous recommandons d'importer le SDK sur la page index qui se charge en premier et de monter l'objet AliyunFP globalement pour qu'il soit accessible depuis les autres pages.
import * as AliyunFP from './feilin.weixin.xxxx.js';
const app = getApp();
app.AliyunFP = AliyunFP;Ajout de la configuration
Avant d'appeler les interfaces du SDK pour mini-programme, ajoutez le nœud feilin-view au fichier axml correspondant :
<view>
<view> Business UI layout </view>
<view id = "feilin-view" style="position:fixed;top:99999rpx;">
<canvas id="feilin-canvas" type="2d" style="width:150px;height:150px;"></canvas>
<canvas id="feilin-webgl" type="webgl" style="width:150px;height:150px;"></canvas>
</view>
</view>Initialisation du SDK
Après avoir importé le SDK pour mini-programme, initialisez-le dans le cycle de vie de la page onReady.
Page({
onReady() {
AliyunFP.init(
{
appKey: 'Enter the AppKey applied for in the Fraud Detection console',
appName: 'Enter the mini program name, defined by the customer',
openId: 'WeChat mini program user ID, optional but recommended',
endpoints: ['https://cloudauth-device.ap-southeast-1.aliyuncs.com']
},(initStatus, deviceToken) => {
console.log("initStatus:" + initStatus + " deviceToken:" + deviceToken);
}
);
}
});Si vous ne spécifiez pas d'adresse de service, le paramètre endpoints utilise la configuration par défaut. Assurez-vous d'ajouter le nom de domaine endpoints à la liste d'autorisation du backend du mini-programme pour garantir son bon fonctionnement.
Adresses de service facultatives pour endpoints :
|
Région |
Adresse de service |
|
Singapour (par défaut) |
|
|
Hong Kong |
|
|
Allemagne |
|
|
États-Unis |
Obtention du deviceToken
Pour obtenir le deviceToken, utilisez la valeur renvoyée par le rappel AliyunFP.init ou appelez AliyunFP.getToken au début d'une action métier (comme l'inscription, la connexion ou l'achat). Prévoyez un délai d'au moins 1 seconde entre l'appel à AliyunFP.getToken et celui à AliyunFP.init.
AliyunFP.getToken()
//Pass bizId to bind this token to a unique business ID.
AliyunFP.getToken(bizId)Exemple d'intégration
Structure de la page
<view>
<view class="page-description">
{{ message }}
</view>
<button type="primary" onTap="onLogin">
Log on
</button>
<view id="feilin-view" style="position: fixed; top: 99999rpx;">
<canvas id="feilin-canvas" type="2d" style="width: 150px; height: 150px;"></canvas>
<canvas id="feilin-webgl" type="webgl" style="width: 150px; height: 150px;"></canvas>
</view>
</view>Implémentation de la logique
import * as AliyunFP from './feilin.weixin.xxxx.js';
const app = getApp();
app.AliyunFP = AliyunFP;
Page({
onReady() {
// Page load complete
console.info("onReady");
AliyunFP.init({
appKey: 'Enter the AppKey applied for in the Fraud Detection console',
appName: 'Enter the mini program name, defined by the customer',
openId: 'WeChat mini program user ID, optional but recommended',
endpoints: ['https://cloudauth-device.ap-southeast-1.aliyuncs.com']
}, (initStatus, deviceToken) => {
console.log("initStatus:" + initStatus + " deviceToken:" + deviceToken);
});
},
onLogin() {
// A business action click, login is used as the example here.
console.info("onLogin!");
const deviceToken = AliyunFP.getToken();
// Pass the deviceToken to the customer's business server
const data = {
"deviceToken": deviceToken,
"otherBusinessParams": ""
};
// Send backend request... The server queries risk information using the deviceToken
}
});Appel de l'API Fraud Detection
Transmettez le deviceToken et les autres paramètres, reportez-vous à Intégration de l'API côté serveur, et appelez l'API Fraud Detection pour l'identification des risques.
FAQ
Pour les questions courantes relatives à l'intégration de Device Fraud Detection, consultez la FAQ.