Chuyển tới nội dung chính

bioMetrics.createKey

bioMetrics.createKey là API tạo ra cặp public và private key RSA 2048, được lưu trữ vào keychain của ios hoặc keystore của android. Private key này sẽ dùng để encrypt data như flow. Public key dùng để gửi lên server, server sẽ dùng public key để decrypt data mà client gửi lên.

Luồng sync key

Lưu ý:

  • Việc lưu trữ cặp key này đòi hỏi thiết bị phải có sensor của bio metrics và đã cài đặt sẵn 1 trong face id, touch id hoặc móng mắt... Sử dụng JSAPI bioMetrics.isSupported để kiểm tra việc này.
  • Khi gọi JSAPI này, các key được tạo ra trước đó sẽ bị xoá đi. Client phải gửi lại public key lên server để update lại public key.
  • Do cặp key này được lưu trữ bảo mật, nên muốn lấy ra cần phải dùng biometrics để xác thực trước.

Tham số

Thuộc tínhKiểu dữ liệuMô tả
successFunctionCallback function khi việc tạo key thành công
failFunctionCallback function khi việc tạo key thất bại
completeFunctionCallback function bất kể thành công hay thất bại

Giá trị trong success callback

Khi việc gọi API thành công, framework sẽ trả về payload chứa các thông tin sau

Thuộc tínhKiểu dữ liệuMô tả
publicKeyStringPublic key được lưu ở dưới device

Ví dụ

import apis from '@v-miniapp/apis'

apis.bioMetrics.createKey({
success: ({ publicKey }) => {
apis.alert({
title: 'Success',
content: `Public Key:${publicKey}`,
})
},
fail: res => {
apis.alert({ title: 'Fail', content: JSON.stringify(res) })
},
})