BlackBerry AppSecure SDK
Què és el BlackBerry AppSecure SDK?
El BlackBerry AppSecure SDK és una eina de desenvolupament que us permet integrar funcions de seguretat avançades amb les vostres aplicacions per a Android i iOS. L'SDK ofereix a qualsevol aplicació mòbil la capacitat d'aprofitar els serveis de seguretat de BlackBerry que detecten, avaluen i responen als riscos ambientals i a una àmplia gamma d'amenaces cibernètiques en temps real. El BlackBerry AppSecure SDK us permet crear aplicacions que siguin resistents als atacs mòbils sofisticats alhora que ofereixen el màxim nivell de protecció per als usuaris i les dades de la vostra organització.
El BlackBerry AppSecure SDK proporciona API que realitzen comprovacions de seguretat del dispositiu per garantir la protecció contra les vulnerabilitats de seguretat, així com API que inicien trucades a BlackBerry Infrastructure i serveis dedicats al núvol per avaluar i respondre a les amenaces. Per exampPer exemple, les capacitats de detecció d'amenaces mòbils de l'SDK inicien trucades als serveis al núvol de BlackBerry Protect, que utilitzen IA sofisticada i aprenentatge automàtic per proporcionar una avaluació en temps real de si una aplicació d'Android és segura o potencialment maliciosa.
Quan integreu el BlackBerry AppSecure SDK, podeu decidir quines comprovacions del dispositiu i els serveis de seguretat voleu implementar i com voleu que la funcionalitat, l'experiència d'usuari i la interfície d'usuari de la vostra aplicació responguin a l'anàlisi i avaluació dels riscos de seguretat.
Qualsevol aplicació d'Android o iOS pot integrar el BlackBerry AppSecure SDK. Les funcions i serveis que ofereix l'SDK no requereixen la instal·lació de cap programari o producte BlackBerry. L'SDK no ofereix capacitats de gestió d'aplicacions o comptes d'usuari, ni de cap nivell de control o administració del dispositiu. Si esteu interessats en el desenvolupament d'aplicacions mòbils segures en combinació amb els controls avançats que ofereix BlackBerry UEM, visiteu BlackBerry Docs per obtenir més informació sobre el BlackBerry Dynamics SDK.
Nota: l'SDK de BlackBerry AppSecure està disponible actualment com a versió beta pública que està subjecta a més proves i canvis per part de BlackBerry. És possible que algunes funcions de l'SDK encara no estiguin disponibles o que requereixin més desenvolupament. L'SDK s'ha posat a disposició per a proves i avaluació primerenques, amb un llançament complet que seguirà en un futur proper. Abans d'utilitzar l'SDK, review i accepteu els termes i condicions de la versió beta.
Característiques clau del BlackBerry AppSecure SDK
Les funcions següents estan disponibles a la versió actual del BlackBerry AppSecure SDK:
| Característica | Plataforma | Descripció |
| Comprovacions de seguretat del dispositiu | ||
| Detecció de jailbreak | iOS | Detecta si el dispositiu està jailbreak. |
| Detecció d'arrel | Android | Detecteu si el dispositiu està arrelat. |
| Detecció de depuració | iOS Android | Detecteu si el mode de depuració està habilitat al dispositiu. |
| Detecció d'enganxament en línia | iOS Android | Detecta l'enganxament en línia, un mètode utilitzat pel programari maliciós per interceptar trucades a funcions de destinació. |
| Detecció d'emulació | Android | Detecteu si l'aplicació s'està executant en un emulador. |
| Comprovació de bloqueig de pantalla | iOS Android | Detecteu si un bloqueig de pantalla està habilitat al dispositiu (per exemple,ample, una contrasenya o PIN). |
| Característica | Plataforma | Descripció |
| Comprovació del mode de desenvolupador | Android | Detecteu si el mode de desenvolupador està habilitat al dispositiu. |
| Comprovació del xifratge del disc | Android | Detecteu si el xifratge de disc està habilitat al dispositiu. |
| Autorització de l'aplicació | iOS Android | Demana als usuaris que estableixin una contrasenya o un PIN per accedir a l'aplicació. De manera opcional, permet que un usuari desbloquegi l'aplicació mitjançant la biometria. |
| Seguretat del programari | ||
| Comprovació mínima del sistema operatiu | iOS Android | Comproveu si el dispositiu compleix un requisit mínim del sistema operatiu que podeu configurar. |
| Comprovació del nivell mínim de pegat de seguretat | Android | Comproveu si el dispositiu compleix un nivell mínim de pedaç de seguretat que podeu configurar. |
| Detecció d'aplicacions malicioses | Android | Utilitzeu els models locals d'aprenentatge automàtic integrats a l'SDK o envieu l'aplicació files als serveis al núvol de BlackBerry Protect per determinar si una aplicació és segura o potencialment maliciosa. |
| Detecció d'aplicacions de càrrega lateral | Android | Detecteu si l'aplicació està instal·lada des d'una font de confiança (per exemple,ample, Google Play o la botiga Samsung Galaxy); Les aplicacions d'una font no fiable es consideren carregades lateralment. |
| Identitat de l'usuari | ||
| Maliciós URL detecció | iOS Android | Enviar URLs, inclòs URLs als missatges de text (si es permet l'accés), als serveis al núvol de BlackBerry Protect
determinar si el URLsón segurs o potencialment maliciosos. |
| Seguretat de dades | ||
| Aplicació segura file sistema i emmagatzematge | iOS Android | Utilitzeu l'emmagatzematge de dades segur, que permet que la vostra aplicació emmagatzemi dades xifrades que només les pot llegir. |
| Còpia de seguretat de dades de l'aplicació als serveis públics del núvol | iOS Android | Bloqueja la còpia de seguretat de dades d'aplicacions als serveis públics del núvol com iCloud i Google Cloud. |
| Autorització d'aplicació | iOS Android | Demana als usuaris que estableixin una contrasenya o un PIN per accedir a l'aplicació. |
| Autenticació biomètrica | iOS Android | Exigir als usuaris que utilitzin un mètode d'autenticació biomètrica (per exemple,ample, una empremta digital). |
| Seguretat de la xarxa | ||
| Característica | Plataforma | Descripció |
| Comprovació de seguretat de la xarxa | iOS Android | En dispositius Android i iOS, si l'SDK no es pot connectar als serveis al núvol de BlackBerry Protect, determina que la xarxa actual no és segura. |
| Comprovació Wi-Fi insegura | Android | Als dispositius Android, l'SDK comprova periòdicament les propietats del punt d'accés Wi-Fi actual per determinar si és segur. |
Les característiques següents s'implementen al sampaplicacions de fitxer que s'inclouen a l'SDK:
- Navegació segura (iOS, Android)
- Detecció d'arrel (Android)
- Detecció de depuració (Android)
- Comprovació de bloqueig de pantalla (iOS, Android)
- Comprovació del mode de desenvolupador (Android)
- Comprovació del xifratge del disc (Android)
- Comprovació mínima del sistema operatiu (iOS, Android)
- Comprovació del nivell de pedaç de seguretat mínim (Android)
- Detecció d'aplicacions malicioses (Android)
- Creació i introducció de PIN (Android)
- Autenticació biomètrica (iOS, Android)
- Comprovació de seguretat de la xarxa (iOS, Android)
- Comprovació Wi-Fi insegura (Android)
Compartint dades i comentaris amb BlackBerry
Les vostres dades i comentaris són valuosos per oferir noves funcions i millores en les noves versions de l'SDK. Us recomanem que activeu l'API de recollida de dades (consulteu la referència de classe DataCollectionRules) que permetrà a BlackBerry rebre informació sobre els entorns, els riscos i les amenaces que us trobeu. Aquesta API no proporciona a BlackBerry cap informació que es pugui utilitzar per identificar usuaris o organitzacions i compleix tots els requisits relacionats amb la privadesa. BlackBerry no utilitzarà la informació que rep per a cap altra finalitat que no sigui la millora del BlackBerry AppSecure SDK.
Per enviar comentaris, visiteu BlackBerry Developer Support i accediu a la BlackBerry Beta Community.
Si trobeu algun problema mentre feu servir l'SDK, podeu compartir el vostre registre files amb BlackBerry Support. Visiteu BlackBerry Developer Support per accedir a la comunitat BlackBerry Beta i consulteu la classe de diagnòstic a la referència de l'API.
Com començar amb el BlackBerry AppSecure SDK
Abans de descarregar, instal·lar o utilitzar l'SDK, heu de llegir l'Acord de llicència de desenvolupament de l'SDK. En baixar, instal·lar i utilitzar l'SDK, accepteu els termes i condicions de l'acord de llicència.
| Descripció del pas |
| Review el Requisits de programari. |
| Registreu l'aplicació amb BlackBerry. |
| Registreu el proveïdor d'identitat de la vostra aplicació. |
| Afegiu l'identificador de client de l'aplicació a la vostra aplicació.
• Afegiu el BlackBerry App Client ID a la vostra aplicació per a Android • Afegiu el BlackBerry App Client ID a la vostra aplicació per a iOS |
| Integreu el BlackBerry AppSecure SDK a la vostra aplicació.
• Integreu el BlackBerry AppSecure SDK a la vostra aplicació per a Android • Integreu el BlackBerry AppSecure SDK a la vostra aplicació per a iOS |
| Inicieu el BlackBerry AppSecure SDK.
• Inicieu el BlackBerry AppSecure SDK a la vostra aplicació per a Android • Inicieu el BlackBerry AppSecure SDK a la vostra aplicació per a iOS |
| Review el nivells d'integració de l'SDK. |
| Exploreu la referència de l'API. |
Requisits de programari
| Requisits de la plataforma |
| Android • Android Studio 3.6.3 o posterior
• Gradle 3.6.3 o posterior • Android SDK API de nivell 26 o superior • Android OS 8 o posterior |
| Requisits de la plataforma |
| iOS • Swift 5 o posterior
• Xcode 11.3 o posterior • CocoaPods 1.7 o posterior • iOS 14 o posterior |
Registreu l'aplicació amb BlackBerry
Heu de registrar la vostra aplicació amb BlackBerry mitjançant el vostre compte en línia de BlackBerry. Si no teniu cap compte, podeu crear-ne un.
- Navegueu al següent URL: https://account.blackberry.com/a/organization//applications/add?capability=mtd
- Inicieu la sessió amb les credencials del vostre compte en línia de BlackBerry (myAccount).
- Introduïu la informació següent:
- Nom de l'aplicació: el nom de la vostra aplicació (per exemple,ample, MyApp).
- Identificador del dret: es recomana que utilitzeu el nom del paquet de la vostra aplicació (per exemple,ample,com.company.myapp).
- Versió: 1.0.0.0
Nota: El número de versió no s'ha d'actualitzar quan actualitzeu l'aplicació i no cal que coincideixi amb la versió nativa de l'aplicació. - Gestió: desactiveu l'opció BlackBerry UEM gestionarà l'aplicació. Heu d'eliminar aquesta opció perquè pugueu utilitzar el vostre propi proveïdor d'identitat per a l'autenticació.
- Capacitats: seleccioneu BlackBerry Protect. Això permet que la vostra aplicació utilitzi els models d'amenaça de BlackBerry Protect.
- Feu clic a Afegeix una aplicació.
Quan hàgiu acabat: registreu el proveïdor d'identitat de la vostra aplicació.
Registreu el proveïdor d'identitat de la vostra aplicació
El BlackBerry AppSecure SDK reutilitza la identitat d'usuari existent a la vostra aplicació per facilitar l'obtenció de la informació més recent sobre amenaces de seguretat del BlackBerry Cloud. La biblioteca treballa amb els vostres sistemes de gestió i identitat d'usuari per proporcionar una autenticació i autorització sòlides.
A la pràctica, un testimoni d'identitat de l'OpenID Connect que pertany a l'usuari que està connectat actualment es proporciona al temps d'execució de BlackBerry AppSecure SDK. BlackBerry valida aquest testimoni amb el punt final d'introspecció de testimoni del vostre proveïdor d'identitat. Aquest procés evita la necessitat de confiar en una clau d'API específica de l'aplicació.
Podeu utilitzar qualsevol proveïdor d'identitat sempre que compleixi amb OpenID Connect (https://openid.net/connect/). Per obtenir més informació, vegeu Informació sobre els IDP que compleixen.
Si no teniu cap proveïdor d'identitats, podeu utilitzar Firebase com a proveïdor d'identitats (IDP).
Quan l'IDP està registrat, se us proporciona un BlackBerry App Client ID que afegiu a la vostra aplicació.
Abans de començar:
- Registreu l'aplicació amb BlackBerry.
- Comproveu que disposeu de la informació següent:
- El descobriment URL del teu IDP
- L'identificador de client autoritzat per a la vostra aplicació
- Al compte en línia de BlackBerry de la vostra organització, al menú de navegació, feu clic a Aplicacions.
- Feu clic a la vostra aplicació.
- A la pestanya IDP, a la secció Proveïdor d'identitat, feu el següent:.
a) En el Descobriment URL camp, escriviu el descobriment URL del proveïdor d'identitat.
b) Al camp ID de client, escriviu l'ID de client autoritzat.
No calen altres camps. - Feu clic a Registre IDP.
Es crea un ID de client de l'aplicació BlackBerry.
Després d'haver acabat:
- Afegiu el BlackBerry App Client ID a la vostra aplicació per a Android
- Afegiu el BlackBerry App Client ID a la vostra aplicació per a iOS
Informació sobre els IDP que compleixen
Podeu integrar el BlackBerry AppSecure SDK a la vostra aplicació mitjançant qualsevol proveïdor d'identitat (IDP) a Internet sempre que compleixi amb OpenID Connect (https://openid.net/connect/).
La taula següent enumera alguns exampfitxers d'IDP que són compatibles i com determinar el descobriment URLs i identificadors de client autoritzats:
| Proveïdor d'identitat | Descobriment URL | Identificadors de client autoritzats |
| Firebase | https://securetoken.google.com/${Project-ID}/.configuració-coneguda/openid | ${Project-ID}
L'identificador del projecte a Firebase. |
| D'acord | https://${yourOktaOrg}/.coneguda/openid- configuració | Un dels OAuth de la teva aplicació
Identificadors de client 2.0 registrats a Okta. |
| https://account.google.com/.wellknown/openid- configuration | Al Google- Services.json de la vostra aplicació file, utilitzeu el valor a "client > oauth_client > client_id". |
Si no teniu accés al vostre IDP per determinar el descobriment URL o identificador de client autoritzat, però teniu un testimoni d'identitat JWT, podeu utilitzar una eina d'inspecció de testimoni de tercers per examinar el testimoni (per exempleampel, https://jwt.io).
- 'iss' és l'emissor del testimoni que podeu utilitzar per determinar el descobriment URL afegint /.well-known/openid-configuration
- 'aud' és el públic destinat al testimoni i és l'identificador de client autoritzat.
Integració de l'IDP i BlackBerry AppSecure SDK a la vostra aplicació per a Android
Aquesta secció descriu com afegir l'IDP i integrar i inicialitzar l'SDK de BlackBerry AppSecure amb una aplicació d'Android.
Afegiu el BlackBerry App Client ID a la vostra aplicació per a Android
Abans de començar: registreu el proveïdor d'identitat de la vostra aplicació i copieu l'identificador de BlackBerry App Client.
A Android Studio, a AndroidManifest.xml file, inclou l'identificador de client de l'aplicació.
Per exampLI:
Després d'haver acabat: Integreu el BlackBerry AppSecure SDK a la vostra aplicació per a Android.
Integreu el BlackBerry AppSecure SDK a la vostra aplicació per a Android
Utilitzeu Gradle per integrar BlackBerry AppSecure SDK al vostre projecte d'Android Studio. Abans de començar: afegiu el BlackBerry App Client ID a la vostra aplicació per a Android.
- Al vostre Gradle de nivell arrel (nivell de projecte). file (build.gradle), afegiu una regla per incloure el dipòsit de BlackBerry Maven.
- Al mòdul a nivell d'aplicació del vostre Gradle file (normalment app/build.gradle), declareu una dependència del BlackBerry AppSecure SDK per a Android.
- Sincronitza la teva aplicació per assegurar-te que es baixin totes les dependències.
Després d'haver acabat: inicialitzeu el BlackBerry AppSecure SDK a la vostra aplicació per a Android.
Inicieu el BlackBerry AppSecure SDK a la vostra aplicació per a Android
Abans de començar: Integreu el BlackBerry AppSecure SDK a la vostra aplicació per a Android.
- Importeu el BlackBerry AppSecure SDK a una activitat.
- Truqueu a enableSecurity.
- Recupereu el testimoni d'identitat del vostre usuari autenticat del vostre IDP.
El testimoni d'identificació és un JSON Web Token (JWT), que és un objecte JSON codificat en Base64 signat criptogràficament. Per recuperar el testimoni d'identificació del vostre IDP, ja heu d'haver autenticat l'usuari.
Si utilitzeu Firebase, el testimoni d'identificació es pot recuperar seguint les instruccions de Firebase per recuperar els testimonis d'identificació dels clients. Altres IDP que compleixen OpenID Connect solen proporcionar un punt final i una biblioteca de client que retorna el testimoni d'identificació. - Proporcioneu el testimoni d'identitat al temps d'execució de BlackBerry AppSecure SDK.
- Confirmeu que l'InitializationState del temps d'execució és "actiu".
Després d'haver acabat: Utilitzant la referència de l'API de BlackBerry AppSecure SDK, configureu la vostra aplicació perquè rebrà una notificació quan es detecti una amenaça.
Integració de l'IDP i BlackBerry AppSecure SDK a la vostra aplicació per a iOS
Aquesta secció descriu com afegir l'IDP i integrar i inicialitzar l'SDK de BlackBerry AppSecure amb una aplicació per a iOS.
Afegiu el BlackBerry App Client ID a la vostra aplicació per a iOS
Abans de començar: registreu el proveïdor d'identitat de la vostra aplicació i copieu l'identificador de BlackBerry App Client.
A Xcode, afegiu l'identificador de client de l'aplicació a "info.plist" de la vostra aplicació.
Per exampLI:
Després d'haver acabat: Integreu el BlackBerry AppSecure SDK a la vostra aplicació per a iOS.
Integreu el BlackBerry AppSecure SDK a la vostra aplicació per a iOS
A Xcode, podeu afegir el BlackBerry AppSecure SDK com a dependència mitjançant CocoaPods. Abans de començar: afegiu el BlackBerry App Client ID a la vostra aplicació per a iOS.
A Xcode, feu el següent per integrar el BlackBerry AppSecure SDK al projecte:
Després d'haver acabat: Inicieu el BlackBerry AppSecure SDK a la vostra aplicació per a iOS.
Inicieu el BlackBerry AppSecure SDK a la vostra aplicació per a iOS
Abans de començar: integreu el BlackBerry AppSecure SDK a la vostra aplicació per a iOS.
- Importeu el mòdul BlackBerrySecurity a la vostra classe.
- Inicieu el marc de BlackBerrySecurity i invoqueu enableSecurity.
- Recupereu el testimoni d'identitat del vostre usuari autenticat del vostre IDP.
El testimoni d'identificació és un JSON Web Token (JWT), que és un objecte JSON codificat en Base64 signat criptogràficament. Per recuperar el testimoni d'identificació del vostre IDP, ja heu d'haver autenticat l'usuari.
Si utilitzeu Firebase, el testimoni d'identificació es pot recuperar seguint les instruccions de Firebase per recuperar els testimonis d'identificació dels clients. Altres IDP que compleixen OpenID Connect solen proporcionar un punt final i una biblioteca de client que retorna el testimoni d'identificació. - Proporcioneu el testimoni d'identitat al temps d'execució de BlackBerry AppSecure SDK.
- Confirmeu que l'InitializationState del temps d'execució és "actiu".
Després d'haver acabat: utilitzant la referència de l'API de BlackBerry AppSecure SDK, configureu la vostra aplicació perquè rebrà una notificació quan es detecti una amenaça.
Nivells d'integració del BlackBerry AppSecure SDK
Podeu aprofitar qualsevol dels nivells d'integració següents del BlackBerry AppSecure SDK per adaptar-vos a les vostres necessitats de seguretat. Per obtenir més informació sobre les API i les funcions que es comenten a continuació, consulteu la referència de l'API d'AppSecure SDK.
| Nivell d'integració | Descripció |
| Línia de base | Registreu la vostra aplicació com a threatStatusListener i feu servir getOverallThreatStatus( ) per obtenir un nivell d'amenaça enumerat global que la biblioteca ha determinat (crític, alt, mitjà, baix, nul). Aleshores, la capa d'aplicació pot determinar què significa aquest nivell d'amenaça per a l'aplicació i prendre mesures. Per exampL'aplicació pot mostrar un missatge gràfic o d'advertència a l'usuari, pot enviar el nivell d'amenaça a un servidor per registrar-lo o tenir en compte en un motor de risc, o pot restringir determinades funcions fins que es redueixi el nivell d'amenaça. |
| Amenaça detallada | Aquest nivell d'integració es recomana si voleu recopilar més informació sobre cada tipus d'amenaça perquè la vostra aplicació pugui executar l'acció més adequada com a resposta. Podeu configurar l'aplicació per consultar informació sobre tipus d'amenaces individuals (per exemple,ample, AppMalware, AppSideLoad, DeviceSecurity, etc.). Cada tipus d'amenaça té un nivell d'amenaça associat per permetre l'aplicació
per recopilar i actuar sobre la informació més detallada. Per exampEn funció de la informació detallada recopilada, l'aplicació pot mostrar diferents gràfics o missatges d'advertència a l'usuari. |
| Amenaça personalitzada | Aquest nivell d'integració proporciona un control encara més granular sobre la detecció i la resposta d'amenaces. Podeu utilitzar ManageFeatures per personalitzar quines amenaces voleu detectar (per exemple,ample, podeu desactivar les comprovacions que no siguin rellevants per a la vostra aplicació). Podeu utilitzar ManageRules per configurar com voleu executar comprovacions específiques (per exemple,ample, podeu executar comprovacions de programari maliciós amb més freqüència). |
Ús de la referència de l'API de BlackBerry AppSecure SDK
La referència de l'API de BlackBerry AppSecure SDK descriu com utilitzar les interfícies, paquets i classes principals de l'SDK:
- Referència de l'API de BlackBerry AppSecure SDK per a Android
- Referència de l'API de BlackBerry AppSecure SDK per a iOS
La taula següent destaca les seccions clau de la referència de l'API:
| Item | Descripció |
| Referència de classe SecurityControl | Inicialitza la biblioteca BlackBerry AppSecure SDK dins de la vostra aplicació perquè es puguin detectar amenaces i proporcionar alertes. |
| Referència de classe AppAuthentication | Mètodes per configurar, canviar i introduir una contrasenya d'aplicació i gestionar l'autenticació biomètrica. |
| Referència de classe d'AppIdentity | Proporciona diversos identificadors d'aplicació que es poden utilitzar per determinar si la sessió de l'usuari prové de la mateixa instància d'aplicació i dispositiu quan s'autentica amb el servidor d'aplicacions. |
| Referència de classe ThreatStatus | Proporciona detalls sobre les amenaces de seguretat relacionades amb el dispositiu, l'aplicació, la xarxa i l'usuari. |
| Referència de classe ContentChecker | Detectar potencialment maliciós URLs o adreces IP per protegir els usuaris de maliciosos webllocs web, intents de pesca, programari maliciós, adware i altres web fonts que representen una amenaça per a les vostres dades. |
| Referència de classe ContentCheckerRules | Configureu regles que canviïn com l'SDK detecta maliciós URLs i adreces IP. |
| Referència de classe DeviceChecker | Realitzeu comprovacions de seguretat al dispositiu per identificar possibles riscos de seguretat. |
| Referència de classe DeviceSecurityRules | Controleu quines comprovacions de seguretat del dispositiu s'avaluen quan es crida a enableSecurity o checkDeviceSecurity. |
| Referència de classe DeviceSoftwareRules | Configureu una comprovació d'un nivell mínim de pedaç de seguretat d'Android i una versió del sistema operatiu. Si el dispositiu no compleix aquests requisits, es considera insegur. |
| Referència de classe de MalwareScanRules | Configura regles que controlen com l'SDK detecta programari maliciós en un dispositiu Android. |
| Referència de classe ManageFeatures | Recuperar l'estat d'una funció de seguretat i activar o desactivar funcions. |
| Referència de classe ManageRules | Configurar i gestionar les regles de seguretat. |
| Paquet com.blackberry.security.file | Emmagatzema les dades d'aplicacions al BlackBerry segur file sistema. |
| Referència de classe PasswordUtility | Comproveu la força de les contrasenyes. |
| Item | Descripció |
| Referència de classe de preferències | Gestioneu les preferències compartides al magatzem de dades segur de BlackBerry. |
| Referència de classe DataCollectionRules | Activeu la recollida de dades anònima per ajudar BlackBerry a millorar les funcions del BlackBerry AppSecure SDK. |
| Classe de diagnòstic
Referència > void uploadLogs (oient de LogsUploadFinishedListener) |
Envieu els registres recents al suport de BlackBerry. |
Resolució de problemes de configuració de l'IDP
| Problema | Possible causa | Possible solució |
| Després d'inicialitzar el BlackBerry AppSecure SDK amb
enableSecurity, l'aplicació no s'executa. |
Falta el BlackBerry App Client ID a AndroidManifest.xml o a info.plist del projecte Xcode. | Veure:
• Afegiu l'identificador de BlackBerry App Client a la teva aplicació per a Android • Afegiu l'identificador de BlackBerry App Client a la teva aplicació iOS |
| Després de trucar a provideToken, es retorna el següent:
• ErrorDomain: AppConfig • ErrorType: ErrorTypeTokenInvalidClientID |
L'identificador de BlackBerry App Client és incorrecte, possiblement perquè el valor no s'ha copiat correctament o perquè s'ha suprimit el client. | Mireu Registreu el proveïdor d'identitat per a la teva aplicació. |
| Després de trucar a provideToken, es retorna el següent:
• ErrorDomain: IDPConfig • ErrorType: ErrorTypeNoBearerPolicyForClient |
El descobriment URL per al vostre proveïdor d'identitat a myEl compte no
coincideix amb l'emissor (iss) al teu testimoni JWT Bearer. |
Actualitzar el descobriment URL per coincidir amb l'emissor de l'IDP.
Mireu Registreu el proveïdor d'identitat per a la teva aplicació. |
| Després de trucar a provideToken, es retorna el següent:
• ErrorDomain: IDPConfig • ErrorType: ErrorTypeAzpClaimMismatch |
Els ID de client autoritzats configurats per al vostre IDP a myEl compte no coincideix amb els camps Audiència (aud) o Part autoritzada (azp) del vostre testimoni JWT Bearer. | Actualitzeu l'identificador de client autoritzat.
Mireu Registreu el proveïdor d'identitat per a la teva aplicació. |
No tinc un proveïdor d'identitat
Si no teniu cap proveïdor d'identitats, podeu crear-ne un amb Firebase. El BlackBerry AppSecure SDK sampl'aplicació 'Pyrite Financial' integra Firebase com a proveïdor d'identitat i està disponible per a Android i iOS.
Podeu utilitzar l'identificador del projecte del projecte Firebase per determinar el descobriment URL i ID de client autoritzat. Consulteu la informació sobre els IDP que compleixen.
Abans de començar: Registreu l'aplicació amb BlackBerry
- Creeu un projecte de Firebase i registreu la vostra aplicació.
- Per a Android, vegeu https://firebase.google.com/docs/android/setup.
- Per a iOS, vegeu https://firebase.google.com/docs/ios/setup.
- Determineu el mecanisme d'autenticació de Google amb el qual voleu integrar-vos. Per example, podeu utilitzar fàcilment l'autenticació de contrasenya (correu electrònic/contrasenya) com a mètode d'inici de sessió i afegir un usuari de prova. La pirita financera sampl'aplicació demostra l'autenticació de la contrasenya.
- Per configurar el vostre Firebase IDP amb BlackBerry, heu de recuperar l'ID del projecte des de la consola de Firebase.
a) Al menú de l'esquerra, al costat de Project Overview, feu clic a la icona d'engranatge view la configuració del projecte.
b) Copieu el valor ID del projecte.
Quan hàgiu acabat: registreu el proveïdor d'identitat de la vostra aplicació
Avís legal
©2022 BlackBerry Limited. Les marques comercials, que inclouen, entre d'altres, BLACKBERRY, BBM, BES, EMBLEM Design, ATHOC, CYLANCE i SECUSMART són marques comercials o marques comercials registrades de BlackBerry Limited, les seves filials i/o afiliades, utilitzades sota llicència, i els drets exclusius d'aquestes marques comercials són expressament reservat. Totes les altres marques comercials són propietat dels seus respectius propietaris.
Aquesta documentació inclou tota la documentació incorporada per referència aquí, com ara la documentació proporcionada o disponible al BlackBerry webEl lloc es proporciona o es fa accessible "TAL COM ÉS" i "COM ESTÀ DISPONIBLE" i sense cap condició, aprovació, garantia, representació o garantia de cap tipus per part de BlackBerry Limited i les seves empreses afiliades ("BlackBerry") i BlackBerry no assumeix cap responsabilitat per cap tipus de document, inexactituds, errors o omissions tècniques o altres en aquesta documentació. Per protegir la informació de propietat i confidencial de BlackBerry i/o els secrets comercials, aquesta documentació pot descriure alguns aspectes de la tecnologia BlackBerry en termes generals. BlackBerry es reserva el dret de canviar periòdicament la informació continguda en aquesta documentació; no obstant això, BlackBerry no es compromet a proporcionar-vos aquests canvis, actualitzacions, millores o altres addicions a aquesta documentació de manera oportuna o en absolut.
Aquesta documentació pot contenir referències a fonts d'informació de tercers, maquinari o programari, productes o serveis inclosos components i contingut com ara contingut protegit per drets d'autor i/o de tercers. webllocs web (col·lectivament, els "Productes i serveis de tercers"). BlackBerry no controla i no es fa responsable de cap producte i servei de tercers, inclosos, sense limitació, el contingut, la precisió, el compliment dels drets d'autor, la compatibilitat, el rendiment, la fiabilitat, la legalitat, la decència, els enllaços o qualsevol altre aspecte dels productes de tercers i Serveis. La inclusió d'una referència a productes i serveis de tercers en aquesta documentació no implica l'aprovació per part de BlackBerry dels productes i serveis de tercers ni del tercer de cap manera.
EXCEPTE EN LA MESURA ESPECÍFICA PROHIBIT PER LA LLEI APLICABLE A LA SEVA JURISDICCIÓ, TOTES LES CONDICIONS, APROBACIONS, GARANTIES, REPRESENTACIONS O GARANTIES DE QUALSEVOL TIPUS, EXPRESSES O IMPLÍCITES, INCLOSANT SENSE LIMITACIÓ, QUALSEVOL GARANTIA, GARANTIES, GARANTIES, GARANTIES, GARANTIES. DE DURABILITAT, FITNESS PER A UN PROPÒSIT O ÚS PARTICULAR, COMERCIABILITAT, QUALITAT COMERCIAL, NO INFRACCIÓ, QUALITAT SATISFACTORIA O TÍTOL, O DERIVADA D'UN ESTATUT O CUSTOM O D'UN CURS DE COMERÇ O ÚS DEL COMERÇ, O RELACIONAT AMB EL DOCUMENT DE LA FORMACIÓ QUEDA EXCLUSIÓ O LA NO FUNCIONAMENT DE CAP PROGRAMARI, MAQUINARI, SERVEI O QUALSEVOL PRODUCTE I SERVEIS DE TERCERS AQUÍ REFERENCIALS. TAMBÉ POTS TENIR ALTRES DRETS QUE VARIEN PER L'ESTAT O LA PROVÍNCIA. ALGUNES JURISDICCIONS MAIG
NO PERMETRE L'EXCLUSIÓ NI LA LIMITACIÓ DE GARANTIES I CONDICIONS IMPLÍCITES. EN LA MESURA PERMESA PER LA LLEI, QUALSEVOL GARANTIA O CONDICIÓ IMPLÍCITA RELACIONADA AMB LA DOCUMENTACIÓ EN LA MESURA QUE NO ES POT EXCLUIR COM S'ESTABLEC MÉS ARRIBA, PERÒ QUE POT LIMITAR, ES LIMITA A NORANTA (90) DIES A PARTIR DE LA DATA DE LA PRIMERA ADQUISICIÓ DEL DOCUMENT. O EL ARTICLE QUE ÉS OBJECTE DE LA RECLAMACIÓ.
EN LA MESURA MÀXIMA PERMESA PER LA LLEI APLICABLE A LA SEVA JURISDICCIÓ, EN CAP CAS SERÀ RESPONSABLE DE CAP TIPUS DE DANYS RELACIONATS AMB AQUESTA DOCUMENTACIÓ O EL SEU ÚS, O EL FUNCIONAMENT O LA NO FUNCIONAMENT DE QUALSEVOL PROGRAMARI, TERRITORI, MAQUINARI, PART. PRODUCTES I SERVEIS AQUÍ AQUÍ ES REFERENCIA, INCLOSOS, SENSE LIMITACIÓ, QUALSEVOL DELS SEGÜENTS DANYS: DIRECTES, CONSEGUENTS, EXEMPLARS, INCIDENTALS, INDIRECTS, ESPECIALS, PUNITIUS O AGRAVATS, DANYS PER PÈRDUA DE BENEFICIS O INTERVENCIONS, INGRESSOS EMPRESARIALS, INGRESSOS O INTERVENCIONS PÈRDUA D'INFORMACIÓ EMPRESARIAL, PÈRDUA D'OPORTUNITAT DE NEGOCI, O CORRUPCIÓ O PÈRDUA DE DADES, FALTES EN LA TRANSMISSIÓ O RECEPCIÓ DE QUALSEVOL DADES, PROBLEMES ASSOCIATS A QUALSEVOL APLICACIÓ UTILITZADA AMB ELS PRODUCTES O SERVEIS DE BLACKBERRY, PÈRDUES DE TEMPS D'INTERVENCIÓ DELS COSTOS DE PRODUCTE SERVEIS O QUALSEVOL PART D'ELLS O DE QUALSEVOL SERVEIS DE TEMPS AEREI, COST DELS BÉNS SUBSTITUTS, COSTS DE COBERTURA, INSTAL·LACIONS O SERVEIS, COST DE CAPITAL O ALTRES PÈRDUES PECUNIÀRIES SIMILÀRIES, TANTO QUE AQUESTS DANYS FOGUEN O NO INCLUSIBLE, AMB INDEMNIAMENT I AMB ELS INDEPENDENTS. AVISAT DE LA POSSIBILITAT D'AQUESTS DANYS.
EN LA MESURA MÀXIMA PERMESA PER LA LLEI APLICABLE A LA SEVA JURISDICCIÓ, BLACKBERRY NO TINDRÀ ALTRES OBLIGACIONS, DEURES NI RESPONSABILITATS AMB CAP UNA RESPONSABILITAT CONTRACTUAL, ELECTRÒNICA O ALTRE CAP A TU, INCLOSA LA RESPONSABILITAT PER NEGLIGÈNCIA O RESPONSABILITAT.
LES LIMITACIONS, EXCLUSIONS I EXENCIONS DE RESPONSABILITAT S'APLICARAN AQUÍ: (A) INDEPENDIENTMENT DE LA NATURALESA DE LA CAUSA DE L'ACCIÓ, DEMANDA O ACCIÓ DE LA VOSTRA ACTIVITAT INCLOSA, PERÒ NO LIMITATIVAMENT, L'INCOVIMENT DEL CONTRACTE, LA NEGLIGÈNCIA, LA RESPONSABILITAT ESTRICTA O LES ALTRE RESPONSABILITAT LEGAL. I SORTIRÀ UN FONAMENT L'INCOPLAMENT O L'INFRACCIÓ DE LA FINALITAT ESENCIAL D'AQUEST ACCORD O DE QUALSEVOL REMEDI QUE HI CONTINGUT; I (B) A BLACKBERRY I A LES SEVES EMPRESES AFILIADES, ELS SEUS SUCCESSORS, ASSIGNATURES, AGENTS, PROVEÏDORS (INCLOSOS ELS PROVEÏDORS DE SERVEIS D'AIRE), DISTRIBUÏDORS AUTORITZATS DE BLACKBERRY (INCLOSOS TAMBÉ ELS PROVEÏDORS DE SERVEIS D'AIRE) I ELS SEUS RESPECTIVES, RESPECTIVES I DIRECTORS CONTRATISTAS.
A MÉS DE LES LIMITACIONS I EXCLUSIONS ESTABLECTEDES ARRIBA, EN CAP CAS CAP DIRECTOR, EMPLEAT, AGENT, DISTRIBUIDOR, PROVEÏDOR, CONTRATISTA INDEPENDENT DE BLACKBERRY O CAP AFILIAT DE BLACKBERRY TENIR RESPONSABILITAT RESPONSABLE DE LA DOCUMENTACIÓ.
Abans de subscriure's, instal·lar o utilitzar qualsevol producte i servei de tercers, és la teva responsabilitat assegurar-te que el teu proveïdor de serveis de temps d'aire ha acceptat donar suport a totes les seves funcions. És possible que alguns proveïdors de serveis de temps d'aire no ofereixin la funcionalitat de navegació per Internet amb una subscripció a BlackBerry® Internet Service. Consulteu amb el vostre proveïdor de serveis la disponibilitat, els acords d'itinerància, els plans de servei i les funcions. La instal·lació o l'ús de productes i serveis de tercers amb els productes i serveis de BlackBerry pot requerir una o més patents, marques comercials, drets d'autor o altres llicències per evitar la infracció o la violació dels drets de tercers. Sou l'únic responsable de determinar si heu d'utilitzar Productes i Serveis de tercers i si cal llicències de tercers per fer-ho. Si és necessari, vostè és responsable d'adquirir-los. No heu d'instal·lar ni utilitzar Productes i Serveis de tercers fins que no s'hagin adquirit totes les llicències necessàries. Qualsevol producte i servei de tercers que s'ofereixi amb els productes i serveis de BlackBerry s'ofereix com a comoditat per a vostè i es proporcionen "TAL CUAL" sense condicions, aprovacions, garanties, representacions o garanties de cap tipus explícites o implícites per part de BlackBerry i BlackBerry. no assumeix cap responsabilitat, en relació amb això. El vostre ús dels Productes i Serveis de tercers es regirà i subjecte a que accepteu els termes de llicències separades i altres acords aplicables amb tercers, excepte en la mesura expressament coberta per una llicència o un altre acord amb BlackBerry.
Les condicions d'ús de qualsevol producte o servei de BlackBerry s'estableixen en una llicència independent o un altre acord amb BlackBerry aplicable. RES D'AQUESTA DOCUMENTACIÓ PRETÉ SUBSTITUIR CAP ACCORD O GARANTIA ESCRIT EXPRESA PROPORCIONATS PER BLACKBERRY PER A PARTS DE QUALSEVOL PRODUCTE O SERVEI DE BLACKBERRY ALTRES QUE AQUESTA DOCUMENTACIÓ.
BlackBerry Enterprise Software incorpora cert programari de tercers. La informació de llicència i copyright associada amb aquest programari està disponible a http://worldwide.blackberry.com/legal/thirdpartysoftware.jsp.
BlackBerry Limited
2200 University Avenue East
Waterloo, Ontario
Canadà N2K 0A7
BlackBerry UK Limited
Planta baixa, The Pearce Building, West Street,
Maidenhead, Berkshire SL6 1RL
Regne Unit
Publicat al Canadà
Documents/Recursos
 |
BlackBerry AppSecure SDK [pdfGuia de l'usuari AppSecure SDK, SDK, AppSecure |
