SIMPLE SOLUTIONS

ASTGENKEY(8) - Linux man page online | Administration and privileged commands

Generates keys for for Asterisk IAX2 RSA authentication.

Chapter
May 14th, 2005
ASTGENKEY(8) Linux Programmer's Manual ASTGENKEY(8)

NAME

astgenkey - generates keys for for Asterisk IAX2 RSA authentication

SYNOPSIS

astgenkey [ -q ] [ -n ] [ keyname ]

DESCRIPTION

astgenkey This script generates an RSA private and public key pair in PEM format for use by Asterisk. The private key should be kept a secret, as it can be used to fake your sys‐ tem's identity. Thus by default (without the option -n ) the script will create a passphrase-encrypted copy of your secret key: without entering the passphrase you won't be able to use it. However if you want to use such a key with Asterisk, you'll have to start it interac‐ tively, because the scripts that start asterisk can't use that encrypted key. The key is identified by a name. If you don't write the name on the command-line you'll be prompted for one. The outputs of the script are: name.pub The public key: not secret. Send this to the other side. name.key The private key: secret. Those files should be copied to /var/lib/asterisk/keys (The private key: on your system. The public key: on other systems) To see the currently-installed keys from the asterisk CLI, use the command keys show

OPTIONS

-q Run quietly. -n Don't encrypt the private key.

SECURITY

The keys are created, using the umask of the user running the command. To create the keys in a secure manner, you should check to ensure that your umask is first set to disallow the private key from being world- readable, such as with the following commands: umask 0066 astgenkey yourkey And then make the key accessible to Asterisk (assuming you run it as user "asterisk"). chown asterisk /var/lib/asterisk/keys/yourname.*

FILES

/var/lib/asterisk/keys

SEE ALSO

asterisk(8), genrsa(1), rsa(1), http://www.voip-info.org/wiki-Asterisk+iax+rsa+auth

AUTHOR

This manual page was written by Tzafrir Cohen <@xorcom.com> Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation. On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-2.
Asterisk May 14th, 2005 ASTGENKEY(8)
This manual Reference Other manuals
astgenkey(8) referred by
refer to asterisk(8) | genrsa(1ssl) | rsa(1ssl)
Download raw manual
Main page Linux Programmer's Manual (+2508) Asterisk (+4) № 8 (+5755)
Go top