Licença mestre para iOS

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:

OZSDK(licenseSources: [LicenseSource], masterLicenseSignature: String? = nil, completion: @escaping ((LicenseData?, LicenseError?) -> Void))

Configuração da licença:

setLicense(licenseSource: LicenseSource, masterLicenseSignature: String? = nil)

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 func getSignature() -> String? {
    let privateKeyBase64String = "the string copied from the privateKey.txt file"
    // com exemplo de chave:
    // let privateKeyBase64String = "a string copiada do arquivo privateKey.txt"
    guard let data = Data(base64Encoded: privateKeyBase64String, options: [.ignoreUnknownCharacters]) else {
      return nil
    }
     
    let sizeInBits = data.count * 8
    let keyDict: [CFString: Any] = [
      kSecAttrKeyType: kSecAttrKeyTypeRSA,
      kSecAttrKeyClass: kSecAttrKeyClassPrivate,
      kSecAttrKeySizeInBits: NSNumber(value: sizeInBits)
    ]
     
    var error: Unmanaged<CFError>?
    guard let secKey = SecKeyCreateWithData(data as CFData, keyDict as CFDictionary, &error) else {
      return nil
    }
     
    guard let bundleID = Bundle.main.bundleIdentifier else {
      return nil
    }
    guard let signature = SecKeyCreateSignature(secKey,
                          .rsaSignatureMessagePKCS1v15SHA512,
                          Data(bundleID.utf8) as CFData,
                          &error) else {
      return nil
    }
    return (signature as Data).base64EncodedString()
  }

Passe a assinatura como a masterLicenseSignature parâmetro, seja durante a inicialização do SDK ou na configuração da licença.

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