blob: 1c712fa3f838d6f6b09e57ac79552df955bcdc8c [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001SYNOPSIS
Zesstrad59c3892019-11-28 20:53:39 +01002 #include <tls.h>
MG Mud User88f12472016-06-24 23:31:02 +02003
4 string hmac(int method, string key, string arg )
Zesstrad59c3892019-11-28 20:53:39 +01005 string hmac(int method, string key, bytes arg )
MG Mud User88f12472016-06-24 23:31:02 +02006 string hmac(int method, string key, int * arg )
Zesstrad59c3892019-11-28 20:53:39 +01007 string hmac(int method, bytes key, string arg )
8 string hmac(int method, bytes key, bytes arg )
9 string hmac(int method, bytes key, int * arg )
MG Mud User88f12472016-06-24 23:31:02 +020010
11BESCHREIBUNG
12 Berechnet den Hashed Message Authenication Code fuer <arg>
Zesstrad59c3892019-11-28 20:53:39 +010013 nach Methode <method> und fuer das Password <key>. Strings
14 werden zuvor in eine UTF-8-Bytefolge konvertiert.
MG Mud User88f12472016-06-24 23:31:02 +020015
16 <method> ist eine der TLS_HASH_-Konstanten in tls.h; nicht jede
17 beschriebene Methode ist in einem gegebenen Driver vorhanden:
18
19 TLS_HASH_SHA1 (1)
20 TLS_HASH_SHA224 (2)
21 TLS_HASH_SHA256 (3)
22 TLS_HASH_SHA384 (4)
23 TLS_HASH_SHA512 (5)
24 TLS_HASH_MD5 (6)
25 TLS_HASH_RIPEMD160 (7)
26
Zesstrad59c3892019-11-28 20:53:39 +010027 Wenn der Driver ohne OpenSSL- oder GCrypt-Unterstuetzung compiliert
28 wurde, erzeugt diese Funktion einen Fehler.
29
MG Mud User88f12472016-06-24 23:31:02 +020030
31BEISPIELE
32 string s;
33
34 s = hmac(TLS_HASH_SHA1, "secret", "Hello");
35 s = hmac(TLS_HASH_SHA1, "secret", ({ 'H', 'e', 'l', 'l', 'o' }) )
36
37GESCHICHTE
38 Eingefuehrt in LDMud 3.3.714
39
40SIEHE AUCH
41 crypt(E), md5(E), md5_crypt(E), sha1(E), hmac(E)