xref: /aosp_15_r20/external/tink/java_src/examples/mac/README.md (revision e7b1675dde1b92d52ec075b0a92829627f2c52a5)
1*e7b1675dSTing-Kang Chang# Java MAC example
2*e7b1675dSTing-Kang Chang
3*e7b1675dSTing-Kang ChangThis example shows how to check the integrity of data with Tink using Message
4*e7b1675dSTing-Kang ChangAuthentication Code (MAC).
5*e7b1675dSTing-Kang Chang
6*e7b1675dSTing-Kang ChangIt demonstrates the basic steps of using Tink, namely loading key material,
7*e7b1675dSTing-Kang Changobtaining a primitive, and using the primitive to do crypto.
8*e7b1675dSTing-Kang Chang
9*e7b1675dSTing-Kang ChangThe key material was generated with:
10*e7b1675dSTing-Kang Chang
11*e7b1675dSTing-Kang Chang```shell
12*e7b1675dSTing-Kang Changtinkey create-keyset --key-template HMAC_SHA256_256BITTAG --out-format JSON \
13*e7b1675dSTing-Kang Chang    --out mac_test_keyset.json
14*e7b1675dSTing-Kang Chang```
15*e7b1675dSTing-Kang Chang
16*e7b1675dSTing-Kang Chang## Build and run
17*e7b1675dSTing-Kang Chang
18*e7b1675dSTing-Kang Chang### Bazel
19*e7b1675dSTing-Kang Chang
20*e7b1675dSTing-Kang Chang```shell
21*e7b1675dSTing-Kang Changgit clone https://github.com/google/tink
22*e7b1675dSTing-Kang Changcd tink/examples/java_src
23*e7b1675dSTing-Kang Changbazel build ...
24*e7b1675dSTing-Kang Chang
25*e7b1675dSTing-Kang Changecho "some data" > data.txt
26*e7b1675dSTing-Kang Changtouch mac_file.txt
27*e7b1675dSTing-Kang Chang
28*e7b1675dSTing-Kang Chang./bazel-bin/mac/mac_example compute \
29*e7b1675dSTing-Kang Chang    ./mac/mac_test_keyset.json data.txt mac_file.txt
30*e7b1675dSTing-Kang Chang
31*e7b1675dSTing-Kang Chang./bazel-bin/mac/mac_example verify \
32*e7b1675dSTing-Kang Chang    ./mac/mac_test_keyset.json data.txt mac_file.txt
33*e7b1675dSTing-Kang Chang```
34