6.2 Lock/Unlock Text

6.2.1 Lock Text

The lockText method of BayunCore class locks text with default encryption-policy and key-generation-policy dictated by server settings.

• Parameters

  • text : Text to be locked.

  • success : Success block to be executed after text is successfully locked, returns locked text through key "lockedText".

  • failure : Failure block to be executed if locking fails, returns BayunError.

Java

String plaintext = "<plaintext>";

// Callbacks for locking text
Handler.Callback success = new Handler.Callback() {
    @Override
    public boolean handleMessage(Message message) {
        String lockedText = message.getData().getString("lockedText", "");
        return false;
    }
}

Handler.Callback failure = new Handler.Callback() {
    @Override
    public boolean handleMessage(Message message) {
        String error = message.getData().getString("BayunError", "");
        Log.d(TAG, "Error locking text.");
        return false;
    }
};

bayunCore.lockText(plaintext, success, failure);

Kotlin

6.2.2 Lock Text with Encryption Policy, Key Generation Policy

The lockText method with encryption policy, key generation policy as parameters locks text with the encryption key dictated by the policy.

• Parameters

  • text : Text to be locked.

  • encryptionPolicy : BayunEncryptionPolicy determines the key for locking.

  • keyGenerationPolicy : BayunKeyGenerationPolicy determines the policy to generate the data encryption key.

  • groupId : GroupId is required if encryptionPolicy is BayunEncryptionPolicyGroup.

  • success : Success block to be executed after text is successfully locked, returns locked text through key "lockedText".

  • failure : Failure block to be executed if locking fails, returns BayunError.

Java

String plaintext = "<plainText>";
int encryptionPolicy = BayunCore.ENCRYPTION_POLICY_COMPANY;
int keyGenerationPolicy = BayunCore.KEY_GENERATION_POLICY_ENVELOPE;
String groupId = "<groupId>";

// Callbacks for locking text
Handler.Callback success = new Handler.Callback() {
    @Override
    public boolean handleMessage(Message message) {
        String lockedText = message.getData().getString("lockedText", "");
        return false;
    }
}

Handler.Callback failure = new Handler.Callback() {
    @Override
    public boolean handleMessage(Message message) {
        String error = message.getData().getString("BayunError", "");
        Log.d(TAG, "Error locking text.");
        return false;
    }
};

bayunCore.lockText(plaintext, encryptionPolicy, keyGenerationPolicy, groupId, success, failure);

Kotlin

If encryption-policy is other than BayunEncryptionPolicyGroup then groupId should be null.

6.2.3 Unlock Text

The unlockText method of BayunCore class unlocks text.

• Parameters

  • text : Text to be unlocked.

  • success : Success block to be executed after text is successfully unlocked, returns unlocked text through key "unlockedText".

  • failure : Failure block to be executed if unlocking fails, returns BayunError.

Java

String lockedText = "<lockedText>";

// Callbacks for unlocking text
Handler.Callback success = new Handler.Callback() {
    @Override
    public boolean handleMessage(Message message) {
        String unlockedText = message.getData().getString("unlockedText", "");
        return false;
    }
}

Handler.Callback failure = new Handler.Callback() {
    @Override
    public boolean handleMessage(Message message) {
        String error = message.getData().getString("BayunError", "");
        Log.d(TAG, "Error unlocking text.");
        return false;
    }
};

bayunCore.unlockText(lockedText, success, failure);

Kotlin