HMACContext

Inherits: Reference < Object Used to create an HMAC for a message using a key.

Description

The HMACContext class is useful for advanced HMAC use cases, such as streaming the message as it supports creating the message over time rather than providing it all at once.

  1. extends Nodevar ctx = HMACContext.new()func _ready():    var key = "supersecret".to_utf8()    var err = ctx.start(HashingContext.HASH_SHA256, key)    assert(err == OK)    var msg1 = "this is ".to_utf8()    var msg2 = "vewy vewy secret".to_utf8()    err = ctx.update(msg1)    assert(err == OK)    err = ctx.update(msg2)    assert(err == OK)    var hmac = ctx.finish()    print(hmac.hex_encode())

And in C# we can use the following.

  1. using Godot;using System;using System.Diagnostics;public class CryptoNode : Node{    private HMACContext ctx = new HMACContext();    public override void _Ready()    {        PoolByteArray key = String("supersecret").to_utf8();        Error err = ctx.Start(HashingContext.HASH_SHA256, key);        GD.Assert(err == OK);        PoolByteArray msg1 = String("this is ").to_utf8();        PoolByteArray msg2 = String("vewy vew secret").to_utf8();        err = ctx.Update(msg1);        GD.Assert(err == OK);        err = ctx.Update(msg2);        GD.Assert(err == OK);        PoolByteArray hmac = ctx.Finish();        GD.Print(hmac.HexEncode());    }}

Note: Not available in HTML5 exports.

Methods

Method Descriptions

  • PoolByteArray finish ( ) PoolByteArray is returned.
  • Error start ( HashType hash_type, PoolByteArray key ) finish has been called.
  • Error update ( PoolByteArray data ) finish is called to append data to the message, but cannot be called until start has been called.