/* * Copyright (C) 2021 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.imsserviceentitlement.entitlement; import android.content.Context; import androidx.annotation.VisibleForTesting; import com.android.imsserviceentitlement.ts43.Ts43Constants.ResponseXmlAttributes; import com.android.imsserviceentitlement.ts43.Ts43Constants.ResponseXmlNode; import com.android.imsserviceentitlement.utils.XmlDoc; import com.android.libraries.entitlement.ServiceEntitlement; import java.util.Optional; import java.util.concurrent.TimeUnit; /** Provides the entitlement characteristic which stored from previous query. */ public class EntitlementConfiguration { /** Default value of version for VERS characteristic. */ private static final int DEFAULT_VERSION = 0; /** Default value of validity for VERS and TOKEN characteristics. */ private static final long DEFAULT_VALIDITY = 0; /** Default value of VoLTE/VoWifi/SMSoverIP entitlemenet status. */ private static final int INCOMPATIBLE_STATE = 2; /** Default raw XML with both version and validity set to -1. */ @VisibleForTesting public static final String RAW_XML_VERS_MINUS_ONE = "" + " " + " " + " " + " " + " " + " " + " " + " " + ""; /** Default raw XML with both version and validity set to -2. */ @VisibleForTesting public static final String RAW_XML_VERS_MINUS_TWO = "" + " " + " " + " " + " " + " " + " " + " " + " " + ""; private final EntitlementConfigurationsDataStore mConfigurationsDataStore; private XmlDoc mXmlDoc; public EntitlementConfiguration(Context context, int subId) { mConfigurationsDataStore = EntitlementConfigurationsDataStore.getInstance(context, subId); mXmlDoc = new XmlDoc(mConfigurationsDataStore.getRawXml().orElse(null)); } // Updates raw XML only. private void update(String rawXml) { mConfigurationsDataStore.set(rawXml); mXmlDoc = new XmlDoc(rawXml); } /** Updates entitlement version and raw XML. */ public void update(int version, String rawXml) { mConfigurationsDataStore.set(version, rawXml); mXmlDoc = new XmlDoc(rawXml); } /** Returns the raw XML stored in the {@link EntitlementConfigurationsDataStore}. */ @VisibleForTesting public String getRawXml() { return mConfigurationsDataStore.getRawXml().orElse(null); } /** Returns the entitlement version stored in the {@link EntitlementConfigurationsDataStore}. */ public int getEntitlementVersion() { return Integer.parseInt(mConfigurationsDataStore.getEntitlementVersion().orElse("0")); } /** * Returns token stored in the {@link EntitlementConfigurationsDataStore} if it is in validity * period. Returns {@link Optional#empty()} if the token was expired or the value of token * validity not positive. */ public Optional getToken() { return isTokenInValidityPeriod() ? mXmlDoc.getFromToken(ResponseXmlAttributes.TOKEN) : Optional.empty(); } private boolean isTokenInValidityPeriod() { long queryTimeMillis = mConfigurationsDataStore.getQueryTimeMillis(); long tokenValidityMillis = TimeUnit.SECONDS.toMillis(getTokenValidity()); if (queryTimeMillis <= 0) { // False if the query time not been set. return false; } // When the token validity is set to 0, the Entitlement Client shall store the token without // any limitation of duration. if (tokenValidityMillis <= 0) { return true; } return (System.currentTimeMillis() - queryTimeMillis) < tokenValidityMillis; } /** * Returns the validity of the token, in seconds. The validity is counted from the time it is * received by the client. If no data exist then returns default value 0. */ public long getTokenValidity() { return mXmlDoc.getFromToken(ResponseXmlAttributes.VALIDITY) .map(Long::parseLong) .orElse(DEFAULT_VALIDITY); } /** * Returns version stored in the {@link EntitlementCharacteristicDataStore}. * If no data exists then return the default value {@link #DEFAULT_VERSION}. */ public String getVersion() { return mXmlDoc.getFromVersion(ResponseXmlAttributes.VERSION) .orElse(String.valueOf(DEFAULT_VERSION)); } /** * Returns the validity of the version, in seconds. The validity is counted from the time it is * received by the client. If no data exist then returns default value 0. */ public long getVersValidity() { return mXmlDoc.getFromVersion(ResponseXmlAttributes.VALIDITY) .map(Long::parseLong) .orElse(DEFAULT_VALIDITY); } public enum ClientBehavior { /** Unknown behavior. */ UNKNOWN_BEHAVIOR, /** Entitlement data is valid during validity seconds. */ VALID_DURING_VALIDITY, /** Entitlement data is valid without any limitation of duration. */ VALID_WITHOUT_DURATION, /** Entitlement data has to be reset to default configuration */ NEEDS_TO_RESET, /** * Entitlement data has to be reset to default configuration except for version and * validity. The Entitlement Client shall not perform client configuration requests anymore * for the services just configured. */ NEEDS_TO_RESET_EXCEPT_VERS, /** * entitlement data has to be reset to default configuration except for version and * validity. The Entitlement Client shall not perform client configuration requests anymore * for the services just configured, until the end-user switches the setting to On. */ NEEDS_TO_RESET_EXCEPT_VERS_UNTIL_SETTING_ON, } /** Returns {@link ClientBehavior} for the service to be configured. */ public ClientBehavior entitlementValidation() { int version = Integer.parseInt(getVersion()); long validity = getVersValidity(); if (version > 0 && validity > 0) { return ClientBehavior.VALID_DURING_VALIDITY; } else if (version > 0 && validity == 0) { return ClientBehavior.VALID_WITHOUT_DURATION; } else if (version == 0 && validity == 0) { return ClientBehavior.NEEDS_TO_RESET; } else if (version == -1 && validity == -1) { return ClientBehavior.NEEDS_TO_RESET_EXCEPT_VERS; } else if (version == -2 && validity == -2) { return ClientBehavior.NEEDS_TO_RESET_EXCEPT_VERS_UNTIL_SETTING_ON; } // Should never reach. return ClientBehavior.UNKNOWN_BEHAVIOR; } /** * Removes the stored configuration and reverts to the default configuration when: * */ public void reset() { // Default configuration of the Characteristics: // - VERS.version = 0 // - VERS.validity = 0 // - TOKEN.token = null (i.e. no value assigned) // - TOKEN.validity =0 update(null); } /** Reverts to the default configurations except the version and validity. */ public void reset(ClientBehavior clientBehavior) { String rawXml = null; if (clientBehavior == ClientBehavior.NEEDS_TO_RESET_EXCEPT_VERS) { rawXml = RAW_XML_VERS_MINUS_ONE; } else if (clientBehavior == ClientBehavior.NEEDS_TO_RESET_EXCEPT_VERS_UNTIL_SETTING_ON) { rawXml = RAW_XML_VERS_MINUS_TWO; } update(rawXml); } }