kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-09-03 03:20:57 +00:00
Code Issues Packages Projects Releases Wiki Activity

manager.c: Add missing parameters to Login documentation

Browse Source 
* Added the AuthType and Key parameters for MD5 authentication.

* Added the Events parameter.

Resolves: #689
(cherry picked from commit b2bcc0cd09)
This commit is contained in:
George Joseph
2024-04-03 07:51:31 -06:00
committed by Asterisk Development Team
parent 7d272b285a
commit d0c4c76853
1 changed files with 28 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
main/manager.c
View File

@@ -165,14 +165,41 @@
<parameter name="Username" required="true">
<para>Username to login with as specified in manager.conf.</para>
</parameter>
<parameter name="AuthType">
<para>Authorization type. Valid values are:</para>
<enumlist>
<enum name="plain"><para>Plain text secret. (default)</para></enum>
<enum name="MD5"><para>MD5 hashed secret.</para></enum>
</enumlist>
</parameter>
<parameter name="Secret">
<para>Secret to login with as specified in manager.conf.</para>
<para>Plain text secret to login with as specified in manager.conf.</para>
</parameter>
<parameter name="Key">
<para>Key to use with MD5 authentication. To create the key, you must
initialize a new MD5 hash, call the <literal>Challenge</literal> AMI action,
update the hash with the response, then update the hash with the secret as specified
in manager.conf. The key value must be the final result of the hash
as a 32 character lower-case hex string without any "0x" prepended.
See the description for an example of creating a key in Python.</para>
</parameter>
<parameter name="Events">
<xi:include xpointer="xpointer(/docs/manager[@name='Events']/syntax/parameter[@name='EventMask']/enumlist)" />
</parameter>
</syntax>
<description>
<para>Login Manager.</para>
<example title="Create an MD5 Key in Python">
import hashlib
m = hashlib.md5()
m.update(response_from_challenge)
m.update(your_secret)
key = m.hexdigest()
## '031edd7d41651593c5fe5c006fa5752b'
</example>
</description>
<see-also>
<ref type="manager">Challenge</ref>
<ref type="manager">Logoff</ref>
</see-also>
</manager>