O OpenSER é um simples servidor de sinalização VoIP usando o SIP. É flexível e altamente configurável, mas não pode ser usado para fornecer serviços de media como voicemail, URA ou conferência. Para tais serviços, o Asterisk é o produto open source mais adequado. Neste documento vai ser apresentado um 'HowTo' de como configurar o Asterisk para usar a base de dados de usuários do OpenSER com o objetivo de implementar o serviço de voicemail. Uma configuração básica do arquivo de configuração do OpenSER é postada no final desta página, a fim de que se possa ter um sistema funcional seguindo tão somente os passos desse tutorial.
NOTA: Se você se deparar com erro durante a compilação na 'sqp/lex.l', a linha 240, relacionado à 'YY_FLUSH_BUFFER', você pode seguramente comentar/remover essa linha.
NOTA: você precisa ter /usr/local/lib no seu arquivo /etc/ld.so.conf ou na variável de ambiente LD_LIBRARY_PATH.
Você pode instalar o MySQL usando o sistema de pacotes de sua distribuição Linux. A única exigência é que o MySQL tenha versão 5.0 ou superior. Por exemplo, http://dotdeb.org fornece pacotes estáveis para o Debian.
Após a instalação, você pode definir a senha de root MySQL com um comando igual a esse: /usr/bin/mysqladmin -u root password 'your-new-password'
Obs.: Também pode ser feito com o Postgresql. Se você tem bom conhecimento deste, pode iniciar sua experiência seguindo as dicas desse tutorial e postando o resultado aqui neste repositório, contribuindo para enriquecer a documentação em Português do Asterisk.
Para criar a base de dados necessária para o OpenSER:
/usr/local/sbin/openser_mysql.sh create
Isso vai criar uma base de dados chamada 'openser' e vai adicionar um usuário 'openser' ao MySQL com acesso completo ao banco. O senha padrão é 'openserrw', altere-a antes (editando usr/local/sbin/openser_mysql.sh) ou imediatamente após você ter criado o base de dados.
Uma vez que você tenha criado a base de dados, você precisa adicionar uma nova coluna a sua tabela 'subscriber' para armazenar o PIN de acesso ao voicemail:
ALTER TABLE subscriber ADD vmail_password varchar(32);
A base de dados necessária para o funcionamento do Asterisk vai conter duas views ('vmusers' e 'sipusers') das tabelas da base de dados do OpenSER, portanto é exigido se tenha o MySQL 5.0+ porque as views foram introduzidas nesta versão. Existe uma tabela real no MySQL ('voicemessages') que vai estocar as mensagens de voz.
CREATE VIEW vmusers AS
SELECT phplib_id as uniqueid,
username as customer_id,
'default' as context,
username as mailbox,
vmail_password as password,
CONCAT(first_name,' ',last_name) as fullname,
email_address as email,
NULL as pager,
datetime_created as stamp
FROM openser.subscriber;
CREATE VIEW sipusers AS
SELECT username as name,
username,
'friend' as type,
NULL as secret,
domain as host,
CONCAT(rpid, ' ','<',username,'>') as callerid,
'default' as context,
username as mailbox,
'yes' as nat,
'no' as qualify,
username as fromuser,
NULL as authuser,
domain as fromdomain,
NULL as insecure,
'no' as canreinvite,
NULL as disallow,
NULL as allow,
NULL as restrictcid,
domain as defaultip,
domain as ipaddr,
'5060' as port,
NULL as regseconds
FROM openser.subscriber;
Adicione um usuário ao MySQL que vai ter direito de acesso completo ao banco de dados 'asterisk'.
GRANT ALL ON asterisk.* to asterisk@localhost IDENTIFIED BY 'some_password';
Se você deseja habilitar MWI, não esqueça de definir o atributo checkmwi.
checkmwi=10
Existem Guidelines a respeito de configuração do canal SIP que você encontra no http://www.voip-info.org/wiki-Asterisk+config+sip.conf. Você não precisa acrescentar nenhum usuário ou peer SIP no arquivo de configuração, eles vão ser carregados da base de dados.
Para nosso tutorial, consideramos que os usuários vão ter ID de 4 dígitos. Para implementar um plano de discagem claro no Asterisk que permita extensibilidade e extensões claras para diferentes serviços, as chamadas para o voicemail serão prefixadas com '1' no proxy OpenSER. Esse prefixo vai ser transparente para os usuários. Se a caixa de voz não existir, o Asterisk vai tocar a mensagem "invalid extension".
Plano de Discagem:
- usuários locais tem extensões de 4 dígitos
- para escutar suas mensagens de voz a partir do seu telefone SIP, o usuário tem que discar *98 (o Asterisk vai anunciar somente pelo PIN)
- para escutar suas mensagens de voz a partir de outro telefone SIP, o usuário tem que discar *981 (o Asterisk vai anunciar pelo ID e PIN da caixa de voz)
- para chamar diretamente e deixar mensagem de voz para o usuário XXXX, o usuário tem que discar *89XXXX
# – auth params –
# Uncomment if you are using auth module
#
modparam("auth_db", "calculate_ha1", yes)
#
# If you set "calculate_ha1" parameter to yes (which true in this config),
# uncomment also the following parameter)
#
modparam("auth_db", "password_column", "password")
# – rr params –
# add value to ;lr param to make some broken UAs happy
modparam("rr", "enable_full_lr", 1)
# initial sanity checks – messages with
# max_forwards==0, or excessively long requests
if (!mf_process_maxfwd_header("10")) {
sl_send_reply("483","Too Many Hops");
exit;
};
if (msg:len >= 2048 ) {
sl_send_reply("513", "Message too big");
exit;
};
# we record-route all messages – to make sure that
# subsequent messages will go through our proxy; that's
# particularly good if upstream and downstream entities
# use different transport protocol
if (!method=="REGISTER")
record_route();
# subsequent messages withing a dialog should take the
# path determined by record-routing
if (loose_route()) {
# mark routing logic in request
append_hf("P-hint: rr-enforced\r\n");
route(1);
};
if (!uri==myself) {
# mark routing logic in request
append_hf("P-hint: outbound\r\n");
route(1);
};
# if the request is for other domain use UsrLoc
# (in case, it does not work, use the following command
# with proper names and addresses in it)
if (uri==myself) {
if (method=="REGISTER") {
if (!www_authorize("openser.org", "subscriber")) {
www_challenge("openser.org", "0");
exit;
};
save("location");
exit;
};
# requests for Media server
if(is_method("INVITE") && !has_totag() && uri=~"sip:\*9") {
route(3);
exit;
}
# mark transaction if user is in voicemail group
if(is_method("INVITE") && !has_totag()
&& is_user_in("Request-URI","voicemail"))
{
xdbg("user [$ru] has voicemail redirection enabled\n");
# backup R-URI
avp_write("$ruri", "i:10");
setflag(2);
};
# native SIP destinations are handled using our USRLOC DB
if (!lookup("location")) {
if(isflagset(2)) {
# route to Asterisk Media Server
prefix("1");
rewritehostport("10.10.10.11:5060");
route(1);
} else {
sl_send_reply("404", "Not Found");
exit;
}
};
append_hf("P-hint: usrloc applied\r\n");
};
route(1);
}
route[1] {
if(isflagset(2))
t_on_failure("1");
if (!t_relay()) {
sl_reply_error();
};
exit;
}
# voicemail access
# - *98 - listen caller's voice messages, being prompted for pin
# - *981 - listen voice messages, being promted for mailbox and pin
# - *98XXXX - leave voice message to XXXX
#
route[3] {
# direct voicemail
if (uri =~ "sip:\*98@" ) {
rewriteuser("1");
xdbg("voicemail access\n");
} else if (uri =~ "sip:\*981@" ) {
strip(4);
rewriteuser("11");
} else if (uri =~ "sip:\*98.+@" ) {
strip(3);
prefix("1");
} else {
xlog("unknown media extension $rU\n");
sl_send_reply("404", "Unknown media service");
exit;
}
# route to Asterisk Media Server
rewritehostport("10.10.10.11:5060");
route(1);
}
failure_route[1] {
if (t_was_cancelled()) {
xdbg("transaction was cancelled by UAC\n");
return;
}
# restore initial uri
avp_pushto("$ruri", "i:10");
prefix("1");
# route to Asterisk Media Server
rewritehostport("10.10.10.11:5060");
resetflag(2);
route(1);
}
Apesar desse tutorial contemplar um cenário específico, ele pode servir de ponto de partida para implementações de outras variações. Como por exemplo, o OpenSER atuando como Proxy Registrador e balanceador de carga para os vários servidores Asterisk (neste caso, o Asterisk implementando as funcionalidades de PABX e Midia Gateway com RTPC). A documentação do módulo dispatcher pode ser lida aqui.
integracao_do_asterisk_com_o_openser.txt (9797 views) · Modificado em: 15/01/2008 21:57 por cleviton
Apoio
Blog
Warning: fsockopen() [function.fsockopen]: php_network_getaddresses: getaddrinfo failed: Name or service not known in /var/www/portal/modules/mod_slick_rss/simplepie.inc on line 2238
Warning: fsockopen() [function.fsockopen]: unable to connect to www.voipmania.com.br:80 (Unknown error) in /var/www/portal/modules/mod_slick_rss/simplepie.inc on line 2238
