Cette rubrique décrit la procédure d'intégration du SDK Device Risk (mini-programme Alipay) afin d'incorporer le SDK dans les applications nécessitant une protection.
Informations générales
Le SDK pour mini-programme Alipay 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 l'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 plusieurs scénarios, tels que l'inscription, la connexion et les campagnes marketing, ce qui permet de se protéger efficacement contre les activités frauduleuses et d'améliorer la sécurité des activités commerciales.
Guide d'intégration du SDK
Téléchargement et importation du SDK pour mini-programme
Téléchargez le SDK pour mini-programme Alipay. Nous vous recommandons d'importer le SDK sur la page index chargée en premier et de monter l'objet AliyunFP globalement pour le rendre accessible depuis les autres pages.
import * as AliyunFP from './feilin.alipay.xxx.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: 'Alipay 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. Veillez à ajouter le nom de domaine endpoints à la liste d'autorisation du backend du mini-programme pour garantir son bon fonctionnement.
Adresses de service disponibles 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 callback AliyunFP.init ou appelez la méthode une fois au début d'une action commerciale (comme l'inscription, la connexion ou l'achat). Prévoyez un délai d'au moins 1 seconde entre AliyunFP.getToken et 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.alipay.xxx.js';
const app = getApp();
app.AliyunFP = AliyunFP;
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: 'Alipay 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 à la rubrique 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.