anchor.diff:  The provided salt should be in hex-encoded String form, be random, and be at least 8 bytes in length.
   Such a salt may be generated using a KeyGenerator:
   
  -[source,java]
  +.Generating a key
  +====
  +.Java
  +[source,java,role="primary"]
   ----
   String salt = KeyGenerators.string().generateKey(); // generates a random 8-byte salt that is then hex-encoded
   ----
  +
  +.Kotlin
  +[source,kotlin,role="secondary"]
  +----
  +val salt = KeyGenerators.string().generateKey() // generates a random 8-byte salt that is then hex-encoded
  +----
  +====
   
   Users may also use the `standard` encryption method, which is 256-bit AES in Cipher Block Chaining (CBC) Mode.
   This mode is not https://en.wikipedia.org/wiki/Authenticated_encryption[authenticated] and does not provide any
  
positive.code: === TextEncryptor
  Use the Encryptors.text factory method to construct a standard TextEncryptor:
  
  [source,java]
  ----
  
  Encryptors.text("password", "salt");
  ----
  
  A TextEncryptor uses a standard BytesEncryptor to encrypt text data.
  Encrypted results are returned as hex-encoded strings for easy storage on the filesystem or in the database.
  
  Use the Encryptors.queryableText factory method to construct a "queryable" TextEncryptor:
  
  [source,java]
  ----
  Encryptors.queryableText("password", "salt");
  ----
  
  The difference between a queryable TextEncryptor and a standard TextEncryptor has to do with initialization vector (iv) handling.
  The iv used in a queryable TextEncryptor#encrypt operation is shared, or constant, and is not randomly generated.
  
negative.code: === BytesEncryptor
  Use the `Encryptors.stronger` factory method to construct a BytesEncryptor:
  
  .BytesEncryptor
  ====
  .Java
  [source,java,role="primary"]
  ----
  Encryptors.stronger("password", "salt");
  ----
  
  .Kotlin
  [source,kotlin,role="secondary"]
  ----
  Encryptors.stronger("password", "salt")
  ----
  ====
  
  The "stronger" encryption method creates an encryptor using 256 bit AES encryption with
  Galois Counter Mode (GCM).
  