Computes a cryptographic SHA1-hashing of the given input field
or array of fields. The hashed output is returned as a
hex string, meaning the
hexadecimal representation of the SHA1 hash of data.
This function can be used to calculate checksums to compare
outside of LogScale or collect multiple fields into a
combined string of fixed length.
Click + next to an example below to get the full details.
SHA-1 Hash Multiple Fields
SHA-1 hash multiple fields using the crypto:sha1() function
Query
logscale
crypto:sha1(field=[a,b,c])
Introduction
In this example, the crypto:sha1() function is used
to hash the fields a,b,c and
return the result into a field named
_sha1.
Step-by-Step
Starting with the source repository events.
logscale
crypto:sha1(field=[a,b,c])
Performs a cryptographic SHA1-hashing of
a,b,c. The
field argument can be omitted to write:
crypto:sha1([a,b,c])
Event Result set.
Summary and Results
The query is used to encode a string using the SHA-1 hash. When called
with multiple values, crypto:sha1() function creates
a single SHA-1 sum from the combined value of the supplied fields.
Combining fields in this way and converting to an SHa-1 can be an
effective method of creating a unique ID for a given fieldset which could
be used to identify a specific event type. The SHA-1 is reproducible (for
example, supplying the same values will produce the same SHA-1 sum), and
so it can sometimes be an effective method of creating unique identifier
or lookup fields for a join() across two different
datasets.
SHA-1 Hash a Field With a Given Value
SHA-1 hash a field with a given value using the crypto:sha1() function
Query
logscale
a:="Hello, world!"|crypto:sha1(a)
Introduction
In this example, the crypto:sha1() function is used
to hash the field a with value
Hello, world! and convert the
result into _sha1.
Step-by-Step
Starting with the source repository events.
logscale
a:="Hello, world!"
Assigns the value Hello, world! to
the field a.
logscale
|crypto:sha1(a)
Performs a cryptographic SHA-1-hashing of
a:= "Hello, world!". The output
value would be _sha1 =
"943a702d06f34599aee1f8da8ef9f7296031d699"
Event Result set.
Summary and Results
The query is used to encode a string using the SHA-1 hash. The hash
generators MD5,
SHA-1, and
SHA-256 are, for example, useful
for encoding passwords or representing other strings in the system as
hashed values.