Api > Crypt


Met de API Crypt is het binnen nodum mogelijk om verschillende hashes te genereren. Sommige API's vereisen deze hash-keys om bijvoorbeeld unieke handtekeningen te maken in een oproep aan de API. api.Crypt maakt gebruik van de hash_hmac-functie van PHP, een encryptiemethode die beproefd is om zijn veiligheid.

De API Crypt_* kent een tweetal methodes, waarvan de eerste alle mogelijke algoritmes die kunnen worden toegepast teruggeeft: api.Crypt_Algos()

Op dit moment worden onder meer de volgende algoritmes ondersteund:

  • sha256 (standaard)
  • sha512
  • md4
  • md5

Deze, en de overige algoritmes die uit de API te halen zijn, kunnen als argument worden meegegeven in de methode die de daadwerkelijke hash maakt: api.Crypt_Hash(string data, string secret, boolean true = bin/false = hex, string algoritme = sha256)
Het derde argument in deze methode kan of true of false zijn. Wanneer deze de waarde true heeft zal de output binair zijn, bij false wordt deze hexadecimaal. Het verschil tussen deze opties zit hem in de manier waarop de waarde wordt opgeslagen. Een binaire variabele bestaat volledig uit de getallen 0 en 1 terwijl hexadecimale variabelen kunnen bestaan uit getallen tussen 0 en 9 en letters tussen A en F. Veel API's verwachten een base64-string, dus onderstaand voorbeeld geeft een binaire hash terug die door de base64_encode-sanitizer is gehaald.

{{ api.Crypt_Hash('username@mydomain.com', 'MySecretK3y!', true)|base64_encode }}

Het is uiteraard ook mogelijk om een hexadecimale hash te genereren op basis van het MD5-algoritme:

{{ api.Crypt_Hash('username@mydomain.com', 'MySecretK3y!', false, 'md5') }}