Licença mestre para Android

A licença mestre é a licença offline que permite usar Mobile SDK com qualquer bundle_id, ao contrário das licenças regulares. Para obter uma licença mestre, crie um par de chaves como mostrado abaixo. Envie-nos a chave pública por e-mail, e nós lhe enviaremos a licença mestre logo depois. Seu aplicativo precisa assinar seu bundle_id com a chave privada, e o Mobile SDK verifica a assinatura usando a chave pública da licença mestre. As licenças mestre têm prazo limitado.

Gerando chaves

Esta seção descreve o processo de criação das suas chaves privada e pública.

Criando uma chave privada

Para criar uma chave privada, execute os comandos abaixo, um por um.

openssl genpkey -algorithm RSA -outform DER -out privateKey.der -pkeyopt rsa_keygen_bits:2048
# para MacOS
base64 -i privateKey.der -o privateKey.txt
# para Linux 
base64 -w 0 privateKey.der > privateKey.txt

Você obterá estes arquivos:

• privateKey.der é uma chave privada .der;

• privateKey.txt for privateKey.der codificado por base64. Esta chave codificada será usada como a assinatura do aplicativo host bundle_id assinatura.

A especificação do comando OpenSSL: https://www.openssl.org/docs/man1.1.1/man1/openssl-pkcs8.html

Criando uma chave pública

Para criar uma chave pública, execute este comando.

openssl rsa -pubout -in privateKey.der -out publicKey.pub

Você obterá o arquivo da chave pública: publicKey.pub. Para obter uma licença, envie-nos este arquivo por e-mail. Nós lhe enviaremos a licença.

Integração do SDK

Inicialização do SDK:

fun init(
    context: Context,
    licenseSources: List<LicenseSource>,
    masterLicenseSignature: String,
    statusListener: StatusListener<LicensePayload>? = null,
)

Para Android 6.0 (nível de API 23) e anteriores:

1. Adicione a implementation 'com.madgag.spongycastle:prov:1.58.0.0' dependência;

2. Antes de criar uma assinatura, chame Security.insertProviderAt(org.spongycastle.jce.provider.BouncyCastleProvider(), 1)

Antes da inicialização do SDK, crie uma assinatura codificada em base64 para o aplicativo host bundle_id usando a chave privada.

Exemplo de criação de assinatura:

private fun getMasterSignature(): String {
    Security.insertProviderAt(org.spongycastle.jce.provider.BouncyCastleProvider(), 1)

    val privateKeyBase64String = "the string copied from the privateKey.txt file"
    // com exemplo de chave:
    // val privateKeyBase64String = "MIIEpAIBAAKCAQEAxnpv02nNR34uNS0yLRK1o7Za2hs4Rr0s1V1/e1JZpCaK8o5/3uGV+qiaTbKqU6x1tTrlXwE2BRzZJLLQdTfBL/rzqVLQC/n+kAmvsqtHMTUqKquSybSTY/zAxqHF3Fk59Cqisr/KQamPh2tmg3Gu61rr9gU1rOglnuqt7FioNMCMvjW7ciPv+jiawLxaPrzNiApLqHVN+xCFh6LLb4YlGRaNUXlOgnoLGWSQEsLwBZFkDJDSLTJheNVn9oa3PXg4OIlJIPlYVKzIDDcSTNKdzM6opkS5d+86yjI1aTKEH3Zs64+QoEuoDfXUxS3TOUFx8P+wfjOR5tYAT+7TRN4ocwIDAQABAoIBAATWJPV05ZCxbXTURh29D/oOToZ0FVn78CS+44Vgy1hprAcfG9SVkK8L/r6X9PiXAkNJTR+Uivly64Oua8//bNC7f8aHgxRXojFmWwayj8iOMBncFnad1N2h4hy1AnpNHlFp3I8Yh1g0RpAZOOVJFucbTxaup9Ev0wLdWyGgQ3ENmRXAyLU5iUDwUSXg59RCBFKcmsMT2GmmJt1BU4P3lL9KVyLBktqeDWR/l5K5y8pPo6K7m9NaOkynpZo+mHVoOTCtmTj5TC/MH9YRHlF15VxQgBbZXuBPxlYoQCsMDEcZlMBWNw3cNR6VBmGiwHIc/tzSHZVsbY0VRCYEbxhCBZkCgYEA+Uz0VYKnIWViQF2Na6LFuqlfljZlkOvdpU4puYTCdlfpKNT3txYzO0T00HHY9YG9k1AW78YxQwsopOXDCmCqMoRqlbn1SBe6v49pVB85fPYU2+L+lftpPlx6Wa0xcgzwOBZonHb4kvp1tWhUH+B5t27gnvRz/rx5jV2EfmWinycCgYEAy8/aklZcgoXWf93N/0EZcfzQo90LfftkKonpzEyxSzqCw7B9fHY68q/j9HoP4xgJXUKbx1Fa8Wccc0DSoXsSiQFrLhnT8pE2s1ZWvPaUqyT5iOZOW6R+giFSLPWEdwm6+BeFoPQQFHf8XH3Z2QoAepPrEPiDoGN1GSIXcCwoe9UCgYEAgoKj4uQsJJKT1ghj0bZ79xVWQigmEbE47qI1u7Zhq1yoZkTfjcykc2HNHBaNszEBks45w7qo7WU5GOJjsdobH6kst0eLvfsWO9STGoPiL6YQE3EJQHFGjmwRbUL7AK7/Tw2EJG0wApn150s/xxRYBAyasPxegTwgEj6j7xu7/78CgYEAxbkI52zG5I0o0fWBcf9ayx2j30SDcJ3gx+/xlBRW74986pGeu48LkwMWV8fO/9YCx6nl7JC9dHI+xIT/kk8OZUGuFBRUbP95nLPHBB0Hj50YRDqBjCBh5qaizSEGeGFFNIfFSKddri3U8nnZTNiKLGCx7E3bjE7QfCh5qoX8ZF0CgYAtsEPTNKWZKA23qTFI+XAg/cVZpbSjvbHDSE8QB6X8iaKJFXbmIC0LV5tQO/KT4sK8g40m2N9JWUnaryTiXClaUGU3KnSlBdkIA+I77VvMKMGSg+uf4OdfJvvcs4hZTqZRdTm3dez8rsUdiW1cX/iI/dJxF4964YIFR65wL+SoRg=="
    val sig = Signature.getInstance("SHA512WithRSA")
    val keySpec = PKCS8EncodedKeySpec(Base64.decode(privateKeyBase64String, Base64.DEFAULT))
    val keyFactory = KeyFactory.getInstance("RSA")
    sig.initSign(keyFactory.generatePrivate(keySpec))
    sig.update(packageName.toByteArray(Charsets.UTF_8))
    return Base64.encodeToString(sig.sign(), Base64.DEFAULT).replace("\n", "")
}

Passe a assinatura como a masterLicenseSignature parâmetro durante a inicialização do SDK.

Se a assinatura for inválida, a inicialização continua normalmente: o SDK verifica a lista de bundle_id incluídos na licença, como faz por padrão sem uma licença mestre.