AAL2ChangeStaticPassword

Mis à jour le 22 Jan 2025
1 Minute à lire

Partager
Sombre
Lumière
PDF

The content is currently unavailable in French. You are viewing the default English version.

Résumé de l’article

Avez-vous trouvé ce résumé utile ?

Merci pour vos commentaires

Function prototype

aat_int32 AAL2ChangeStaticPassword (
                                    TDigipassBlob*   DPData,
                                    TKernelParms*    CallParms,
                                    aat_ascii*       NewStaticPassword1,
                                    aat_ascii*       NewStaticPassword2);

Description

This function is used with a Digipass authenticator that can use static passwords (e.g. Digipass GO 1). It allows administrators to provide a new static password on a mandatory basis. As this function is critical, only an authenticated user should be able to use it.

For a list of the characters that can be used for the new static password, see Supported new static password charset.

Parameters

Table: Parameters (AAL2ChangeStaticPassword)
Type	Name	Use	Description
TDigipassBlob *	DPData	I/O	authenticator application BLOB. Upon return from the function call, this BLOB must be rewritten to the application database to reflect changes.
TKernelParms *	CallParms	I	Structure of runtime parameters to use during this function call.
aat_ascii *	NewStaticPassword1	I	First entry of the password change trial. Up to 8 printable ASCII-EBCDIC invariant characters. Must be null-terminated. For a list of the characters that can be used for the new static password, see Supported new static password charset.
aat_ascii *	NewStaticPassword2	I	Second entry confirmation of the password change trial. Must be identical to NewStaticPassword1.

Return codes

Table: Return codes (AAL2ChangeStaticPassword)
Code	Meaning	Code	Meaning
0	Success	804	New password too long
130	Invalid response pointer	805	Password not equal
412	Invalid checksum software	1000	Function does not support EMV-CAP
413	Invalid Base64 format	1103	Unlock Version 2 not supported
510	Invalid Digipass data pointer	1118	Unsupported BLOB
801	Static password not supported	-1501	Memory allocation failed
803	New password too short

Supported new static password charset

The following table lists the supported characters for the data fields of AAL2ChangeStaticPassword with associated hexadecimal values in ASCII and EBCDIC.

Table: List of supported characters
Character	Hex ASCII value	Hex EBCDIC value	Character	Hex ASCII value	Hex EBCDIC value
!	0x21	0x5A	P	0x50	0xD7
“	0x22	0x7F	Q	0x51	0xD8
#	0x23	0x7B	R	0x52	0xD9
$	0x24	0x5B	S	0x53	0xE2
%	0x25	0x6C	T	0x54	0xE3
&	0x26	0x50	U	0x55	0xE4
'	0x27	0x7D	V	0x56	0xE5
(	0x28	0x4D	W	0x57	0xE6
)	0x29	0x5D	X	0x58	0xE7
*	0x2A	0x5C	Y	0x59	0xE8
+	0x2B	0x4E	Z	0x5A	0xE9
,	0x2C	0x6B	[	0x5B	0xAD
-	0x2D	0x60	\	0x5C	0xE0
.	0x2E	0x4B	]	0x5D	0xBD
/	0x2F	0x61	^	0x5E	0x5F
0	0x30	0xF0	_	0x5F	0x6D
1	0x31	0xF1	`	0x60	0x79
2	0x32	0xF2	a	0x61	0x81
3	0x33	0xF3	b	0x62	0x82
4	0x34	0xF4	c	0x63	0x83
5	0x35	0xF5	d	0x64	0x84
6	0x36	0xF6	e	0x65	0x85
7	0x37	0xF7	f	0x66	0x86
8	0x38	0xF8	g	0x67	0x87
9	0x39	0xF9	h	0x68	0x88
:	0x3A	0x7A	i	0x69	0x89
;	0x3B	0x5E	j	0x6A	0x91
<	0x3C	0x4C	k	0x6B	0x92
=	0x3D	0x7E	l	0x6C	0x93
>	0x3E	0x6E	m	0x6D	0x94
?	0x3F	0x6F	n	0x6E	0x95
@	0x40	0x7C	o	0x6F	0x96
A	0x41	0xC1	p	0x70	0x97
B	0x42	0xC2	q	0x71	0x98
C	0x43	0xC3	r	0x72	0x99
D	0x44	0xC4	s	0x73	0xA2
E	0x45	0xC5	t	0x74	0xA3
F	0x46	0xC6	u	0x75	0xA4
G	0x47	0xC7	v	0x76	0xA5
H	0x48	0xC8	w	0x77	0xA6
I	0x49	0xC9	x	0x78	0xA7
J	0x4A	0xD1	y	0x79	0xA8
K	0x4B	0xD2	z	0x7A	0xA9
L	0x4C	0xD3	(	0x7B	0xC0
M	0x4D	0xD4	\|	0x7C	0x4F
N	0x4E	0xD5	)	0x7D	0xD0
O	0x4F	0xD6	~	0x7E	0xA1

Cet article vous a-t-il été utile ?

What's Next

AAL2CINIT_APrepare

Table des matières

Function prototype
Description
Parameters
Return codes
Supported new static password charset