Droit d'accès au service IMS

À partir d'Android 12, Android est compatible avec la configuration des droits d'accès aux services TS.43, une spécification GSMA qui définit l'étape de validation des droits d'accès pour l'activation de services y compris la voix sur Wi-Fi (VoWiFi), la voix sur LTE (VoLTE), les SMS sur IP (SMSoIP), l'activation des services sur l'appareil (ODSA) des appareils compagnons eSIM (associés à l'appareil demandeur) et les informations sur le forfait de données.

Pour prendre en charge cette spécification, Android fournit une fonctionnalité de droits d'accès aux services IMS qui permet à un fournisseur de services d'informer les appareils mobiles de l'état des services réseau IP Multimedia Subsystem (IMS). Cette fonctionnalité de droits d'accès permet à l'appareil d'interroger le serveur de droits d'accès de l'opérateur tel que défini par la spécification GSMA TS.43 pour l'état des droits d'accès IMS à l'aide de l' authentification EAP-AKA sans que les utilisateurs aient à saisir manuellement des identifiants.

Les opérateurs disposant de serveurs de droits d'accès IMS peuvent utiliser la fonctionnalité de droits d'accès aux services IMS pour le provisionnement des services. L'adoption de cette fonctionnalité présente les avantages suivants :

  • Réduit les coûts de test et de certification pour les opérateurs, car cette fonctionnalité de droits d'accès peut être utilisée sur plusieurs produits et OEM.
  • Réduit les frais de développement pour les fabricants d'appareils grâce à une application Android standard.
  • Permet aux fabricants d'appareils et aux opérateurs de contribuer au code de la fonctionnalité, car elle est Open Source.
  • Fournit une gestion des adresses d'urgence pour les opérateurs d'Amérique du Nord.

Architecture

La figure suivante décrit l'architecture et le comportement de la fonctionnalité de droits d'accès aux services IMS.

Fonctionnalité de droit d'accès TS.43

Figure 1. Architecture de la fonctionnalité de droits d'accès TS.43

Comme le montre la figure 1, l'architecture de la fonctionnalité de droits d'accès aux services IMS comprend les composants suivants :

  • service_entitlement Bibliothèque statique de l'API de service TS.43: cette bibliothèque implémente la spécification TS.43, interagit avec le serveur de droits d'accès d'un opérateur et expose des API orientées application pour chaque cas d'utilisation TS.43.

  • ImsServiceEntitlement application cliente: cette application utilise l'API de service TS.43. L'application implémente des éléments d'interface utilisateur, y compris des vues Web pour afficher le portail de services de l'opérateur permettant aux utilisateurs d'activer des services, et interagit avec d'autres composants Android pour gérer l'expérience utilisateur de bout en bout.

    Pour en savoir plus sur la configuration d'Android pour qu'il fonctionne avec le serveur de droits d'accès basé sur TS.43 d'un opérateur, consultez l'application ImsServiceEntitlement.

Les lignes numérotées de la figure 1 montrent comment les composants de la fonctionnalité de droits d'accès aux services IMS communiquent entre eux. Chaque étape est décrite ci-dessous :

(1) L'application cliente appelle l'API de service TS.43 pour lancer une requête de droits d'accès aux services.

(2) L'API de service TS.43 envoie une requête HTTP au serveur de droits d'accès de l'opérateur pour lancer un défi EAP-AKA.

(3) L'API de service TS.43 appelle des API de téléphonie (par exemple, getIccAuthentication) pour compléter la réponse au défi EAP-AKA.

(4) Le service TS.43 reçoit des données de droits d'accès ou de configuration du service du serveur de droits d'accès de l'opérateur une fois la réponse EAP-AKA validée.

(5) Le service TS.43 renvoie les données de droits d'accès ou de configuration à l'application cliente.

(6) L'application cliente gère les données et affiche éventuellement le portail de services de l'opérateur pour que l'utilisateur puisse terminer l'activation du service.

Intégration

Cette section décrit le processus d'intégration de la bibliothèque service_entitlement et de l'application ImsServiceEntitlement.

Étant donné qu'il n'existe aucune dépendance d'API Android 12, la bibliothèque service_entitlement et l'application ImsServiceEntitlement peuvent être rétroportées vers des plates-formes Android inférieures.

Bibliothèque service_entitlement

Étant donné que la bibliothèque service_entitlement est liée de manière statique à l'application ImsServiceEntitlement, aucune étape supplémentaire n'est requise pour intégrer la bibliothèque à l'application ImsServiceEntitlement.

La bibliothèque service_entitlement peut être intégrée à vos propres applications pour les cas d'utilisation TS.43, tels que le forfait Internet et l'ODSA. La bibliothèque peut également être intégrée à une application pour les cas d'utilisation de droits d'accès non TS.43 basés sur le protocole EAP-AKA.

Les API à utiliser pour ces cas d'utilisation sont décrites ci-dessous :

  • Application TS.43 utilisant le protocole HTTP TS.43 implémenté dans la bibliothèque : utilisez les API de la classe ServiceEntitlement.
  • Application non TS.43 utilisant le protocole EAP-AKA implémenté dans la bibliothèque : utilisez les API exposées dans la classe EapAkaHelper.

Application ImsServiceEntitlement

Par défaut, Android inclut l'ImsServiceEntitlementapplication installée dans la partition du produit en tant qu'application privilégiée. Pour configurer l'application, utilisez les clés CarrierConfig suivantes :

Clé Valeur
KEY_ENTITLEMENT_SERVER_URL_STRING URL du serveur de droits d'accès de l'opérateur. Le préfixe https:// doit être inclus.
KEY_FCM_SENDER_ID_STRING ID d'expéditeur FCM de l'opérateur.

Ne définissez pas cette valeur si FCM n'est pas requis par l'opérateur.
KEY_SHOW_VOWIFI_WEBVIEW_BOOL Définissez la valeur sur true si l'opérateur exige une interface utilisateur de portail Web pour que les utilisateurs s'inscrivent au service VoWiFi. Par exemple, pour accepter les conditions d'utilisation ou saisir une adresse d'urgence.

Cette option est généralement requise par les opérateurs d'Amérique du Nord.
KEY_WFC_EMERGENCY_ADDRESS_CARRIER_APP_STRING
Définissez la valeur sur com.android.imsserviceentitlement/.WfcActivationActivity, si KEY_SHOW_VOWIFI_WEBVIEW_BOOL est true.
KEY_IMS_PROVISIONING_BOOL Définissez la valeur sur true si l'opérateur exige le provisionnement réseau des services IMS (VoLTE/VoWiFi/SMSoIP) en arrière-plan.

Cette option est requise par certains opérateurs européens.
KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL Définissez la valeur sur true si KEY_IMS_PROVISIONING_BOOL est true.

Le trafic HTTP vers le serveur de droits d'accès et le portail Web d'un opérateur passe par le réseau par défaut, par exemple, les données mobiles par défaut ou le Wi-Fi.

Partenaires GMS : les opérateurs suivants sont compatibles avec l'application de droits d'accès TS.43 dans Android 12, conformément à la spécification TS.43 v5.0 :

  • États-Unis : CSpire, US Cellular, Cellcom
  • France: Orange

Interface utilisateur système supplémentaire pour le provisionnement IMS

Cette section explique comment les OEM peuvent prendre en charge des éléments d'interface utilisateur système supplémentaires liés au provisionnement des services IMS (par exemple, lorsqu'une notification s'affiche lorsque le VoWiFi est provisionné).

L'application ImsServiceEntitlement définit l'état de provisionnement VoWiFi dans la plate-forme à l'aide de l' ProvisioningManager.setProvisioningIntValue(KEY_VOICE_OVER_WIFI_ENABLED_OVERRIDE, value) API système. Cette API est également utilisée pour la VoLTE (avec KEY_VOLTE_PROVISIONING_STATUS) et le SMSoIP (avec KEY_SMS_OVER_IP_ENABLED).

L'interface utilisateur système peut ensuite lire l'état de provisionnement à l'aide de getProvisioningIntValue ou en enregistrant un rappel pour surveiller le changement d'état de provisionnement via registerProvisioningChangedCallback.

Remplacer les configurations pour les tests

Procédez comme suit pour modifier temporairement le comportement de l'application ImsServiceEntitlement à des fins de test. Pour en savoir plus sur la façon de remplacer les configurations d'opérateur, consultez Remplacer les configurations d'opérateur.

Ignorer le processus d'inscription VoWiFi

Pour ignorer le processus d'inscription VoWiFi et activer directement le VoWiFi, remplacez la configuration d'opérateur KEY_WFC_EMERGENCY_ADDRESS_CARRIER_APP_STRING et définissez sa valeur sur une chaîne vide.

Ignorer le provisionnement IMS

Pour ignorer le provisionnement IMS, rendre les services IMS disponibles et permettre aux utilisateurs d' activer ces services sans provisionnement réseau, remplacez la configuration d'opérateur KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL et définissez sa valeur sur false.

Modifier l'URL du serveur de droits d'accès

Pour modifier l'URL du serveur de droits d'accès, remplacez la configuration d'opérateur KEY_ENTITLEMENT_SERVER_URL_STRING et définissez sa valeur sur la chaîne d'URL attendue. Vous devez inclure le préfixe https://.

Remplacer les configurations d'opérateur

À partir d'Android 11, les commandes de remplacement de la configuration d'opérateur sont intégrées et disponibles avec les droits racine.

La commande suivante montre comment remplacer la clé de configuration d'opérateur carrier_volte_provisioning_required_bool et définir sa valeur sur false. Vous pouvez exécuter la commande plusieurs fois pour remplacer plusieurs configurations.

adb root
adb shell cmd phone cc set-value -p carrier_volte_provisioning_required_bool false

Pour effacer tous les remplacements, utilisez la commande suivante :

adb shell cmd phone cc clear-values

Pour en savoir plus, exécutez la commande suivante :

adb shell cmd phone cc