Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples
Videos
New in version: 9.0   9.1   9.2   9.3   9.4   9.5   10.0   10.1   10.2   10.3    Statistic  

Hash.SHA1.HMAC

Returns the a SHA1 HMAC based on the key and the data string.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Hash 3.1 Yes Yes Yes Yes Yes
MBS( "Hash.SHA1.HMAC"; key; data { ; Flags } )   More

Parameters

Parameter Description Example value
key The key text to use. "Hello"
data The data text to use. "World"
Flags Optional
Various flags you can combine by addition.
Pass 1 for getting result Base64 encoded instead of Hex encoded.
Pass 2 if key is Hex encoded and plugin should decode it first.
Pass 4 if data is hex encoded and plugin should decode it first.
Pass 8 for base64URL encoding. (new in v10.3)
0

Result

Returns the hash string.

Description

Returns the a SHA1 HMAC based on the key and the data string.
Keyed-Hash Message Authentication Code is a way to add salt to a hash for more security.

Please be aware that text can result in different hashes if it contains line endings. You may want to make sure that line endings are right with the Text.ReplaceNewline function before you compare hashes to results in other development tools. FileMaker uses Mac line endings by default and most examples for Javascript use Unix line endings.

Examples

Hash empty string

MBS( "Hash.SHA1.HMAC"; ""; "" )

Example result: FBDB1D1B18AA6C08324B7D64B71FB76370690E1D

Hash a test string

MBS( "Hash.SHA1.HMAC"; "key"; "The quick brown fox jumps over the lazy dog")

Example result: DE7C9B85B8B78AA6BC8A7A36F70A90701C9DB4D9

FileMaker 16 vs. Plugin:

# MBS Plugin:
MBS( "Hash.SHA1.HMAC"; "Key"; "Data")
# Same via FileMaker 16 native:
HexEncode( CryptAuthCode ( "Data" ; "SHA1" ; "Key" ))

See also

Example Databases

Blog Entries

Created 18th August 2014, last changed 22nd May 2020


Hash.SHA1   -   Hash.SHA256

Feedback: Report problem or ask question.




Links
MBS Xojo PDF Plugins