opensipsbrasil - wiki - Contribuições do(a) usuário(a) [pt-br]

Opensips 1.9

2021-04-15T22:57:58Z

Admin:

{| class="wikitable"
|-
|Precisando de recursos de númeração para fazer seus testes ? Contrate conosco em [http://www.brdvoz.com.br BRDVoz]
|Ou talvez gostaria de uma consultoria no seu proejto ? Também estamos disponiveis em [https://www.brdsoft.com.br BRDSoft]
|-
|}

Este tutorial tem por finalidade, demonstrar o processo de instalação e configuração do OpenSIPS 1.9 utilizando a opção do mesmo para gerar o arquivo de script.

==Informacoes==
Para este tutorial foi utilizado um Debian 6.0 com kernel 64bits
A versão utilizada do OpenSIPS foi 1.9.1

==Dependencias==
<pre>
apt-get install gcc make libncurses5-dev libnewt-dev libxml2-dev unixodbc \
unixodbc-dev libmysqlclient15-dev libxmlrpc-c3-dev libexpat1-dev zlib1g-dev \
m4 bison flex libpcre3-dev mysql-server vim apache2-mpm-prefork libapache2-mod-php5 \
php5-mysql php5-xmlrpc php-pear ngrep g++ libjpeg62-dev libssl-dev libcurl4-gnutls-dev
</pre>

==Download==
cd /usr/src/
wget -c http://opensips.org/pub/opensips/1.9.1/src/opensips-1.9.1_src.tar.gz
tar -xzvf opensips-1.9.1_src.tar.gz
cd opensips-1.9.1-tls

==Compilação==
make menuconfig

No menu selecione a opção '''Configure Compile Options''' , depois selecione '''Configure Excluded Modules'''

Selecione os seguintes módulos
* db_mysql
* dialplan
* regex
* mi_xmlrpc
* presence
* presence_dialoginfo
* presence_mwi
* presence_xml
* xcap
* xcap_client

Após as alterações salve os parametros e selecione no primeiro menu a opção '''Compile & Install OpenSIPS'''

O processo deverá demorar um pouco, ao termino você voltará ao menu, neste selecione a opção '''Generate OpenSIPS Script''' , selecione então '''Residential Script''', e depois '''Configure Residencial Script'''

Neste marque as seguintes opções

* USE_ALIASES
* USE_AUTH
* USE_DBACC
* USE_DBUSRLOC
* USE_DIALOG
* USE_MULTIDOMAIN
* USE_NAT
* USE_PRESENCE
* USE_DIALPLAN
* HAVE_INBOUND_PSTN
* HAVE_OUTBOUND_PSTN
* USE_DR_PSTN

Com todas as opções selecionadas selecione para gerar o script, o script será gerado no diretório '''etc''' dentro do diretório dos fontes, no meu caso o nome do arquivo foi '''opensips_residential_2013-8-17_11:37:45.cfg''' , no seu caso a data obviamente estará diferente.

==Configuração==

Precisamos executar alguns procedimentos para darmos continuidade, seguem os comandos abaixo.
cd /usr/src/opensips-1.9.1-tls
ln -s /usr/etc/opensips /etc/
cp packaging/debian/opensips.default /etc/default/opensips
cp packaging/debian/opensips.init /etc/init.d/opensips
chmod +x /etc/init.d/opensips
update-rc.d opensips defaults

Edite o arquivo /etc/default/opensips , a altere o parametro '''RUN_OPENSIPS''' para yes

groupadd opensips
mkdir /var/run/opensips
useradd -d /var/run/opensips/ -s /bin/false -g opensips opensips
chown -R opensips.opensips /var/run/opensips

Agora podemos dar continuidade.

===opensipsctlrc===
O arquivo /etc/opensips/opensipsctlrc possue alguns parametros que precisamos definir referente a nossa estrutura, você deve analisar o script para verificar oque mais você pode usar, mas em ambito geral abaixo estão as opções que precisamos.

SIP_DOMAIN:
* este parametro é o dominio que o script usará para gerar os dados no banco de dados, você pode usar o ip do seu servidor ou um nome de dominio se você possuir.

DBENGINE
DBHOST
DBNAME
DBRWUSER
DBRWPW
DBROOTUSER
* Estas opções são referentes ao banco de dados que utilizaremos, configure de acordo com seu ambiente

ALIASES_TYPE
* Esta opcão deve ser definida como DB, assim os alias das contas SIP estarão no banco de dados

MI_CONNECTOR=FIFO
* Defina esta opção como /tmp/opensips_fifo

Após configurar, vamos executar o comando abaixo para criar nosso banco de dados.
opensipsdbctl create opensips

===Instalando o RTP Proxy===
<pre>
cd /usr/src/
wget -c http://b2bua.org/chrome/site/rtpproxy-1.2.1.tar.gz
tar -xzvf rtpproxy-1.2.1.tar.gz
cd rtpproxy-1.2.1
./configure
make
make install
groupadd rtpproxy
useradd -d /var/run/rtpproxy -s /bin/true -g rtpproxy rtpproxy
mkdir /var/log/rtpproxy
mkdir /var/run/rtpproxy
chown -R rtpproxy.rtpproxy /var/log/rtpproxy
chown -R rtpproxy.rtpproxy /var/run/rtpproxy
</pre>

====Arquivo de inicialização====
'''/etc/init.d/rtpproxy'''
<pre>
#!/bin/bash
#
# Este script e de autoria de Mike Tesliuk
# qualquer falha no mesmo por favor informe
# atraves do email mike (a) tesliuk.com
#
### BEGIN INIT INFO
# Provides: rtpproxy
# Required-Start: $syslog $network $local_fs $time
# Required-Stop: $syslog $network $local_fs
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start the RTPPROXY server
# Description: Start the RTPPROXY server
### END INIT INFO

PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin
USELOG=1
USER=rtpproxy
# Altere o ip abaixo para o ip de seu sistema
IPADDR="_SEU_IP_AQUI_"

. /lib/lsb/init-functions

start(){
echo "Iniciando RTP PROXY "
if [ -z $(pidof rtpproxy) ]; then
if [ "${USELOG}" = "1" ]; then
echo "Iniciando com LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7890 -u $USER -F -f -d DBUG 2&> /var/log/rtpproxy/rtpproxy.log &
else
echo "Iniciando sem LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7890 -u $USER -F -f -d DBUG 2&> /dev/null
fi

if [ -n $(pidof rtpproxy) ]; then
echo "START OK"
fi
else
echo "Processo ja em execucao"
fi
}

stop(){

if [ -z $(pidof rtpproxy) ]; then
echo "Processo nao encontrado"
else
kill -9 $(pidof rtpproxy)
if [ -n $(pidof rtpproxy) ]; then
echo "STOP OK"
else
echo "Falha em realizar stop do servico"
fi

fi
}

case $1 in
start)
start
;;
stop)
stop
;;
restart)
stop
start

;;
*)
echo "Utilize: stop | start | restart"
;;
esac

</pre>

Vamos dar permissao e colocar na inicialização
chmod +x /etc/init.d/rtpproxy
update-rc.d rtpproxy defaults
/etc/init.d/rtpproxy start

===Arquivo autogerado===

copie o arquivo que foi gerado para você para /etc/opensips/opensips.cfg

O Arquivo padrão precisa de alguns ajustes, basicamente localize as opções '''CUSTOMIZE ME''' existentes no arquivo.

Um parametro extra que vamos adicionar é a opção db_url para o modulo uri, para isso localize a opção onde está sendo carregado modulo uri.so e então adicione abaixo.

<pre>
modparam("uri", "db_url",
"mysql://opensips:opensipsrw@localhost/opensips") # CUSTOMIZE ME
</pre>

Termine de alterar os parametros onde traz a opção CUTOMIZE ME para os dados referentes.

Ao terminar as configurações temos que então configurar o nosso plano de discagem para chamadas externas.

Localize a opção dp_translate, comente a mesma, nós não a usaremos aqui, abaixo acrescente
<pre>
# definimos aqui pstn como padrao 0
$avp(pstn)=0;
xlog("Verificando $rU para do_routing");

# Ligacao local (achar uma forma para pegar o ddd na base do usuario)
# routeid 0 para gateway de ligacoes locais (acrescentar 5511)
if ($rU=~"^0[0-9]{8}$") {
$avp(pstn)=1;
$avp(routeid)=0;

# ligacao ddd (0 + ddd + numero)
# routeid 1 para gateway para ddd (acrescenta 55)
}else if( $rU =~ "^0[0-9]{2}[0-9]{8}$" ){
$avp(pstn)=1;
$avp(routeid)=1;

# Ligacao ldn (00 + numero)
# routeid 2 para remover o 00 e enviar a chamada diretamente
}else if( $rU =~ "^00[0-9]+$" ){
$avp(pstn)=1;
$avp(routeid)=2;

}

# pstn esta definido e vamos rotear
if($avp(pstn) == 1){
xlog("Regra pre do_routing");

# utilizamos o routeid que definimos para achar o gateway
# correto para este perfil de chamada
if (!do_routing("$avp(routeid)")) {
send_reply("500","No PSTN Route found");
exit;
}

route(relay);
exit;
}

</pre>

Descendo um pouco o arquivo, após a sessão do if(!lookup('location','m'), acrescente a seguinte opção.
rtpproxy_offer();

Esta opção deve estar na linha anterior a linha abaixo
if (isbflagset(NAT)) setflag(NAT);

Seu arquivo deverá estar semelhante ao arquivo abaixo.

<pre>

#
# $Id: opensips_residential.m4 9742 2013-02-05 10:24:48Z vladut-paiu $
#
# OpenSIPS residential configuration script
# by OpenSIPS Solutions <team@opensips-solutions.com>
#
# This script was generated via "make menuconfig", from
# the "Residential" scenario.
# You can enable / disable more features / functionalities by
# re-generating the scenario with different options.#
#
# Please refer to the Core CookBook at:
# http://www.opensips.org/Resources/DocsCookbooks
# for a explanation of possible statements, functions and parameters.
#

####### Global Parameters #########

debug=3
log_stderror=no
log_facility=LOG_LOCAL0

fork=yes
children=4

/* uncomment the following lines to enable debugging */
debug=6
fork=no
log_stderror=yes

/* uncomment the next line to enable the auto temporary blacklisting of
not available destinations (default disabled) */
#disable_dns_blacklist=no

/* uncomment the next line to enable IPv6 lookup after IPv4 dns
lookup failures (default disabled) */
#dns_try_ipv6=yes

/* comment the next line to enable the auto discovery of local aliases
based on revers DNS on IPs */
auto_aliases=no

listen=udp:_SEU_IP_AQUI_:5060 # CUSTOMIZE ME

disable_tcp=yes

disable_tls=yes

####### Modules Section ########

#set module path
mpath="/usr/lib/opensips/modules/"

#### SIGNALING module
loadmodule "signaling.so"

#### StateLess module
loadmodule "sl.so"

#### Transaction Module
loadmodule "tm.so"
modparam("tm", "fr_timer", 5)
modparam("tm", "fr_inv_timer", 30)
modparam("tm", "restart_fr_on_each_reply", 0)
modparam("tm", "onreply_avp_mode", 1)

#### Record Route Module
loadmodule "rr.so"
/* do not append from tag to the RR (no need for this script) */
modparam("rr", "append_fromtag", 0)

#### MAX ForWarD module
loadmodule "maxfwd.so"

#### SIP MSG OPerationS module
loadmodule "sipmsgops.so"

#### FIFO Management Interface
loadmodule "mi_fifo.so"
modparam("mi_fifo", "fifo_name", "/tmp/opensips_fifo")
modparam("mi_fifo", "fifo_mode", 0666)

#### URI module
loadmodule "uri.so"
modparam("uri", "use_uri_table", 0)
modparam("uri", "db_url", "mysql://opensips:_SUA_SENHA_AQUI_@localhost/opensips")

#### MYSQL module
loadmodule "db_mysql.so"

#### USeR LOCation module
loadmodule "usrloc.so"
modparam("usrloc", "nat_bflag", "NAT")
modparam("usrloc", "db_mode", 2)
modparam("usrloc", "db_url",
"mysql://opensips:_SUA_SENHA_AQUI_@localhost/opensips") # CUSTOMIZE ME

#### REGISTRAR module
loadmodule "registrar.so"
modparam("registrar", "tcp_persistent_flag", "TCP_PERSISTENT")
modparam("registrar", "received_avp", "$avp(received_nh)")
/* uncomment the next line not to allow more than 10 contacts per AOR */
#modparam("registrar", "max_contacts", 10)

#### ACCounting module
loadmodule "acc.so"
/* what special events should be accounted ? */
modparam("acc", "early_media", 0)
modparam("acc", "report_cancels", 0)
/* by default we do not adjust the direct of the sequential requests.
if you enable this parameter, be sure the enable "append_fromtag"
in "rr" module */
modparam("acc", "detect_direction", 0)
modparam("acc", "failed_transaction_flag", "ACC_FAILED")
/* account triggers (flags) */
modparam("acc", "db_flag", "ACC_DO")
modparam("acc", "db_missed_flag", "ACC_MISSED")
modparam("acc", "db_url",
"mysql://opensips:_SUA_SENHA_AQUI_@localhost/opensips") # CUSTOMIZE ME

#### AUTHentication modules
loadmodule "auth.so"
loadmodule "auth_db.so"
modparam("auth_db", "calculate_ha1", yes)
modparam("auth_db", "password_column", "password")
modparam("auth_db", "db_url",
"mysql://opensips:_SUA_SENHA_AQUI_@localhost/opensips") # CUSTOMIZE ME
modparam("auth_db", "load_credentials", "")

#### ALIAS module
loadmodule "alias_db.so"
modparam("alias_db", "db_url",
"mysql://opensips:_SUA_SENHA_AQUI_@localhost/opensips") # CUSTOMIZE ME

#### DOMAIN module
loadmodule "domain.so"
modparam("domain", "db_url",
"mysql://opensips:_SUA_SENHA_AQUI_@localhost/opensips") # CUSTOMIZE ME
modparam("domain", "db_mode", 1) # Use caching
modparam("auth_db|usrloc|uri", "use_domain", 1)

### XCAP
loadmodule "xcap.so"
modparam("xcap", "db_url",
"mysql://opensips:_SUA_SENHA_AQUI_@localhost/opensips") # CUSTOMIZE ME
modparam("xcap", "integrated_xcap_server", 1)

#### PRESENCE modules
loadmodule "presence.so"
loadmodule "presence_xml.so"
modparam("presence", "db_url",
"mysql://opensips:_SUA_SENHA_AQUI_@localhost/opensips") # CUSTOMIZE ME
modparam("presence_xml", "force_active", 1)
modparam("presence", "server_address", "sip:127.0.0.1:5060") # CUSTOMIZE ME

#### DIALOG module
loadmodule "dialog.so"
modparam("dialog", "dlg_match_mode", 1)
modparam("dialog", "default_timeout", 21600) # 6 hours timeout
modparam("dialog", "db_mode", 2)
modparam("dialog", "db_url",
"mysql://opensips:_SUA_SENHA_AQUI_@localhost/opensips") # CUSTOMIZE ME

#### NAT modules
loadmodule "nathelper.so"
modparam("nathelper", "natping_interval", 10)
modparam("nathelper", "ping_nated_only", 1)
modparam("nathelper", "received_avp", "$avp(received_nh)")

loadmodule "rtpproxy.so"
modparam("rtpproxy", "rtpproxy_sock", "udp:localhost:7890") # CUSTOMIZE ME

#### DIALPLAN module
loadmodule "dialplan.so"
modparam("dialplan", "db_url",
"mysql://opensips:_SUA_SENHA_AQUI_@localhost/opensips") # CUSTOMIZE ME

#### DYNAMMIC ROUTING module
loadmodule "drouting.so"
modparam("drouting", "db_url",
"mysql://opensips:_SUA_SENHA_AQUI_@localhost/opensips") # CUSTOMIZE ME

####### Routing Logic ########

# main request routing logic

route{
force_rport();

if (nat_uac_test("8")) {
if (is_method("REGISTER")) {
fix_nated_register();
setbflag(NAT);
} else {
fix_nated_contact();
setflag(NAT);
}
}

if (!mf_process_maxfwd_header("10")) {
sl_send_reply("483","Too Many Hops");
exit;
}

if (has_totag()) {
# sequential request withing a dialog should
# take the path determined by record-routing
if (loose_route()) {

# validate the sequential request against dialog
if ( $DLG_status!=NULL && !validate_dialog() ) {
xlog("In-Dialog $rm from $si (callid=$ci) is not valid according to dialog\n");
## exit;
}

if (is_method("BYE")) {
setflag(ACC_DO); # do accounting ...
setflag(ACC_FAILED); # ... even if the transaction fails
} else if (is_method("INVITE")) {
# even if in most of the cases is useless, do RR for
# re-INVITEs alos, as some buggy clients do change route set
# during the dialog.
record_route();
}

if (check_route_param("nat=yes"))
setflag(NAT);

# route it out to whatever destination was set by loose_route()
# in $du (destination URI).
route(relay);
} else {
if (is_method("SUBSCRIBE") && $rd == "_SEU_IP_AQUI_:5060") { # CUSTOMIZE ME
# in-dialog subscribe requests
route(handle_presence);
exit;
}
if ( is_method("ACK") ) {
if ( t_check_trans() ) {
# non loose-route, but stateful ACK; must be an ACK after
# a 487 or e.g. 404 from upstream server
t_relay();
exit;
} else {
# ACK without matching transaction ->
# ignore and discard
exit;
}
}
sl_send_reply("404","Not here");
}
exit;
}

# CANCEL processing
if (is_method("CANCEL"))
{
if (t_check_trans())
t_relay();
exit;
}

t_check_trans();

if ( !(is_method("REGISTER") || is_from_gw() ) ) {

if (is_from_local())
{

# authenticate if from local subscriber
# authenticate all initial non-REGISTER request that pretend to be
# generated by local subscriber (domain from FROM URI is local)
if (!proxy_authorize("", "subscriber")) {
proxy_challenge("", "0");
exit;
}
if (!db_check_from()) {
sl_send_reply("403","Forbidden auth ID");
exit;
}

consume_credentials();
# caller authenticated

} else {
# if caller is not local, then called number must be local

if (!is_uri_host_local()) {
send_reply("403","Rely forbidden");
exit;
}
}

}

# preloaded route checking
if (loose_route()) {
xlog("L_ERR",
"Attempt to route with preloaded Route's [$fu/$tu/$ru/$ci]");
if (!is_method("ACK"))
sl_send_reply("403","Preload Route denied");
exit;
}

# record routing
if (!is_method("REGISTER|MESSAGE"))
record_route();

# account only INVITEs
if (is_method("INVITE")) {

if(has_totag()){
engage_rtp_proxy();
}
# create dialog with timeout
if ( !create_dialog("B") ) {
send_reply("500","Internal Server Error");
exit;
}

setflag(ACC_DO); # do accounting
}

if (!is_uri_host_local()) {
append_hf("P-hint: outbound\r\n");

route(relay);
}

# requests for my domain

if( is_method("PUBLISH|SUBSCRIBE"))
route(handle_presence);

if (is_method("REGISTER"))
{

# authenticate the REGISTER requests
if (!www_authorize("", "subscriber"))
{
www_challenge("", "0");
exit;
}

if (!db_check_to())
{
sl_send_reply("403","Forbidden auth ID");
exit;
}

if ( 0 ) setflag(TCP_PERSISTENT);

if (!save("location"))
sl_reply_error();

exit;
}

if ($rU==NULL) {
# request with no Username in RURI
sl_send_reply("484","Address Incomplete");
exit;
}

# apply DB based aliases
alias_db_lookup("dbaliases");

# apply transformations from dialplan table
#xlog("Verificando se temos rota para este destino $ru/$ru");
#dp_translate("0","$rU/$rU");

# definimos aqui pstn como padrao 0
$avp(pstn)=0;
xlog("Verificando $rU para do_routing");

# Ligacao local (achar uma forma para pegar o ddd na base do usuario)
# routeid 0 para gateway de ligacoes locais (acrescentar 5511)
if ($rU=~"^0[0-9]{8}$") {
$avp(pstn)=1;
$avp(routeid)=0;

# ligacao ddd (0 + ddd + numero)
# routeid 1 para gateway para ddd (acrescenta 55)
}else if( $rU =~ "^0[0-9]{2}[0-9]{8}$" ){
$avp(pstn)=1;
$avp(routeid)=1;

# Ligacao ldn (00 + numero)
# routeid 2 para remover o 00 e enviar a chamada diretamente
}else if( $rU =~ "^00[0-9]+$" ){
$avp(pstn)=1;
$avp(routeid)=2;

}

# pstn esta definido e vamos rotear
if($avp(pstn) == 1){
xlog("Regra pre do_routing");

# utilizamos o routeid que definimos para achar o gateway
# correto para este perfil de chamada
if (!do_routing("$avp(routeid)")) {
send_reply("500","No PSTN Route found");
exit;
}

route(relay);
exit;
}

# do lookup with method filtering
if (!lookup("location","m")) {
if (!db_does_uri_exist()) {
send_reply("420","Bad Extension");
exit;
}

t_newtran();
t_reply("404", "Not Found");
exit;
}

# esta entrada fez a magica do sdp
rtpproxy_offer();
if (isbflagset(NAT)) setflag(NAT);

# when routing via usrloc, log the missed calls also
setflag(ACC_MISSED);
route(relay);
}

route[relay] {
# for INVITEs enable some additional helper routes
if (is_method("INVITE")) {

if (isflagset(NAT)) {
rtpproxy_offer();
}

t_on_branch("per_branch_ops");
t_on_reply("handle_nat");
t_on_failure("missed_call");
}

if (isflagset(NAT)) {
add_rr_param(";nat=yes");
}

if (!t_relay()) {
send_reply("500","Internal Error");
};
exit;
}

# Presence route
route[handle_presence]
{
if (!t_newtran())
{
sl_reply_error();
exit;
}

if(is_method("PUBLISH"))
{
handle_publish();
}
else
if( is_method("SUBSCRIBE"))
{
handle_subscribe();
}

exit;
}

branch_route[per_branch_ops] {
xlog("new branch at $ru\n");
}

onreply_route[handle_nat] {
#fix_nated_sdp("3");
rtpproxy_answer();

if (nat_uac_test("1"))
fix_nated_contact();
if ( isflagset(NAT) )
rtpproxy_answer("ro");
xlog("incoming reply\n");
}

failure_route[missed_call] {
if (t_was_cancelled()) {
exit;
}

# uncomment the following lines if you want to block client
# redirect based on 3xx replies.
##if (t_check_status("3[0-9][0-9]")) {
##t_reply("404","Not found");
## exit;
##}

}

local_route {
if (is_method("BYE") && $DLG_dir=="UPSTREAM") {

acc_db_request("200 Dialog Timeout", "acc");

}
}

</pre>

Agora precisamos criar usuários, alias, e rota de saida.

==Criando um usuario==
opensipsctl add NOME_DO_USUARIO SENHA_DO_USUARIO
opensipsctl add USUARIO2 SENHA_USUARIO2

==Criando um alias==
O alias normalmente é utilizado para um número referente a este usuário, seja um número de telefone ou um ramal.
opensipsctl alias_db add 05551234@IP_OU_DOMINIO NOME_DO_USUARIO@IP_OU_DOMINIO

Neste caso, se um usuário ou uma chamada de fora vier para 05551234 ela será direcionada para o usuário especificado

==Criando os troncos==
Agora precisamos criar os troncos de saida, você deve inserir no banco de dados, veja abaixo um exemplo.

<pre>
mysql> select * from dr_gateways;
+----+------+------+-------------+-------+------------+-------+------------+-------------+
| id | gwid | type | address | strip | pri_prefix | attrs | probe_mode | description |
+----+------+------+-------------+-------+------------+-------+------------+-------------+
| 1 | 1 | 2 | IP_DO_TRONCO| 0 | 5511 | | 2 | LOCAL SP |
| 3 | 2 | 2 | IP_DO_TRONCO| 1 | 55 | | 0 | LDN |
| 4 | 3 | 2 | IP_DO_TRONCO| 2 | | | 0 | LDI |
+----+------+------+-------------+-------+------------+-------+------------+-------------+
</pre>

Veja que temos duas opções especificas ali, que é o strip, o strip é para remover um digito do numero recebido,
a opção pri_prefix é para adicionar um prefixo antes da discagem

Com esta opção agora precisamos criar a regra que vai entrar para um tronco o outro, abaixo
segue as entradas do banco de dados.

<pre>
mysql> select * from dr_rules;
+--------+---------+--------+---------+----------+---------+--------+-------+-------------+
| ruleid | groupid | prefix | timerec | priority | routeid | gwlist | attrs | description |
+--------+---------+--------+---------+----------+---------+--------+-------+-------------+
| 4 | 0 | | | 0 | 1 | 1 | | Local |
| 5 | 1 | | | 0 | 1 | 2 | | LDN |
| 6 | 2 | | | 0 | 1 | 3 | | LDI |
+--------+---------+--------+---------+----------+---------+--------+-------+-------------+
</pre>

Neste caso o detalhe está gwlist e no groupid, nós no nosso arquivo opensips.cfg nas regras para as ligações externas, definimos que ele buscará pelo grupo 0 para local, pelo grupo 1 para ldn , e pelo grupo 2 para internacional, e cada um destes grupos corresponde a um ip da tabela da anterior.

Com estes dados criados, podemos dar inicio nos testes.

==Iniciando o OpenSIPS==

Precisamos iniciar o OpenSIPS antes de mais nada, então para isso execute o comando abaixo.
/etc/init.d/opensips start

Se o sistema levantar, então é só dar sequencia, se não levantar, habilite as opções de debug do arquivo e então execute o comando abaixo para tnetar localizar o erro.
/etc/init.d/opensips debug

==Fazendo chamadas==

Para fazer as chamadas as instruções são:
LOCAL: 0 + 8 DIGITOS
LDN : 0 + DDD + 8 DIGITOS
LDI : 00 + NUMERO

Para chamar um usuário você pode discar o alias que voce atribuiu ou o proprio nome do usuário se for softphone

Opensips NAT Script com RTPproxy

2021-04-15T22:57:36Z

Admin:

OpenSIPs e Asterisk

2021-04-15T22:56:29Z

Admin:

{| class="wikitable"
|-
|Precisando de recursos de númeração para fazer seus testes ? Contrate conosco em [http://www.brdvoz.com.br BRDVoz]
|Ou talvez gostaria de uma consultoria no seu proejto ? Também estamos disponiveis em [https://www.brdsoft.com.br BRDSoft]
|-
|}

<table>
<tr><td style="background-color: red;"><b><font color=white> Falta realizar os ajustes / testes para o NAT no mais esta tudo funcionado adequadamente a principio </font></b></td></tr>
</table>

Este tutorial é baseado em um tutorial similar porém utilizando Kamailio e Freeswtich, se quiser verificar o tutorial original acesse http://kb.asipto.com/freeswitch:kamailio-3.1.x-freeswitch-1.0.6d-sbc.

Para esta implementação utilizamos Debian 7.0 amd64 , OpenSIPS 1.9 e Asterisk 1.8.23

==Funcionalidades==
Este tutorial tem por objetivo atingir as seguintes funcionalidades.
*Autenticação de usuário
*Registro de usuário
*Localização de usuário (encaminhamento de chamadas)
*Roteamento de chamadas

Através do Asterisk estenderemos estas funcionalidades agregando.
*Correio de voz (Voicemail)
*Conferencia
*SBC ( Pode ser utilizado para transcoding, esconder topologia, play de mensagens e tarifação )
*Outros serviços de media (Anuncios, Ura's e coisas do tipo)

==Definições==
Para um melhor entendimento da solução vamos expor aqui algumas definições de nosso sistema.
*Usuários locais terão ramais com 3 digitos (ex: 101, 102, 103)
*Identidade do correio de voz será o mesmo do ramal
*Serviços de media (acesso a voicemail e outros) receberão rotas de 4 digitos
*Opensips e Asterisk utilizarão o mesmo servidor (Neste caso IP: 10.254.254.6)
*Os serviços rodarão nas portas 5060 (opensips) , 5090 (Asterisk)

==Funcionamento==
A autenticação do usuário será realizada pelo OpenSIPs, quando uma chamada é autenticada então ela serguirá:
*Se o usuário de destino não está online a chamada será enviada para o Asterisk para função de correio de voz
*Se o usuário está online a chamada será encaminhada para o Asterisk, dest forma é possivel acionar funcionalidades como anuncios, definição de tempo de chamada, forçar codecs e outras funcionalidades.
*Asterisk envia a chamada novamente para o OpenSIPs que verificará no location e entregará a chamada para o usuário.
*Se a chamada não for atendida o Opensips irá re-encaminhar para o Asterisk direcionando para função de voicemail

==OpenSIPs==
Vamos iniciar o processo de instalação com o OpenSIPs, siga os procedimentos abaixo para evitar qualquer dificuldade.

===Dependencias===
Execute o comando abaixo para instalar todas as dependencias necessárias
<pre>
apt-get install gcc make libncurses5-dev libnewt-dev libxml2-dev unixodbc \
unixodbc-dev libmysqlclient15-dev libxmlrpc-c3-dev libexpat1-dev zlib1g-dev \
m4 bison flex libpcre3-dev mysql-server vim apache2-mpm-prefork libapache2-mod-php5 \
php5-mysql php5-xmlrpc php-pear ngrep g++ libjpeg62-dev libssl-dev
</pre>

Durante a instalação o sistema irá lhe perguntar a senha de root para o servidor MySQL é importante que você se lembre da mesma posteriormente pois utilizaremos a mesma.

===Compilando o OpenSIPs===
Para manter um padrão onde os dados estao vamos utilizar o diretório /usr/src/ para o download de código fonte.

cd /usr/src/
wget -c http://opensips.org/pub/opensips/1.9.1/src/opensips-1.9.1_src.tar.gz
tar -xzvf opensips-1.9.1_src.tar.gz
cd opensips-1.9.1-tls/
make menuconfig

Neste ponto o sistema irá abrir uma tela com algumas opções para selecionar, Acesse a primeira opção do menu, no submenu acesse a segunda opção ( Configure excluded modules ), selecione os módulos db_mysql , dialplan , mi_xmlrpc , presence e presence_xml

Agora volte ao submenu, e selecione a opção Save Changes, volte para o menu principal e selecione '''Compile and Install OpenSips''' , deixe que o sistema execute suas funções.

Ao finalizar a compilação você retornará ao menu, va na opção '''Exit and Save all changes'''

===Preparando a Configuração===

Antes de darmos inicio ao arquivo de configuração, vamos ajustar algumas questões, o opensips instala os arquivos (se voce nao alterar o parametro) em /usr, consequentemente as configurações ficam em /usr/etc , eu por padrão faço um link para o diretório /etc, assim acesso as configurações em /etc/opensips

ln -s /usr/etc/opensips /etc/

No caso do debian o script de inicialização utiliza um arquivo extra de configuração
cp packaging/debian/opensips.default /etc/default/opensips

Para o script de inicialização execute o comando abaixo
cp packaging/debian/opensips.init /etc/init.d/opensips
chmod +x /etc/init.d/opensips
update-rc.d opensips defaults

Edite o arquivo /etc/default/opensips , a altere o parametro '''RUN_OPENSIPS''' para yes

Você pode notar que no arquivo é mensionado o usuário de execução do opensips como opensips, então vamos ter de criar este usuário ( e grupo )

groupadd opensips
mkdir /var/run/opensips
useradd -d /var/run/opensips/ -s /bin/false -g opensips opensips
chown -R opensips.opensips /var/run/opensips

===Configurando o opensipsctl===
O opensipsctl (e opensipsdbctl) utilizam o arquivo de configuração /etc/opensips/opensipsctlrc, abaixo segue o conteúdo do arquivo. (Sugiro que você faça um backup dos arquivos originais para ter uma copia, existem parametros que você pode estudar depois).

<pre>
DBENGINE=MYSQL
DBHOST=localhost
DBNAME=opensips
DBRWUSER=opensips
DBRWPW="opensipsrw"
SIP_DOMAIN=10.254.254.6 ### caso voce esteja usando outro ip altere aqui

DBROOTUSER="root"
INSTALL_EXTRA_TABLES=ask
ALIASES_TYPE="DB"
MI_CONNECTOR=FIFO:/tmp/opensips_fifo
# VERIFY_ACL=1
# ACL_GROUPS="local ld int voicemail free-pstn"
# VERBOSE=1
# STORE_PLAINTEXT_PW=0
# NOHLPRINT=1
PID_FILE=/var/run/opensips/opensips.pid
</pre>

===Criando o banco de dados===
Agora que temos nosso arquivo configurado vamos fazer a criação do banco de dados, execute o comando abaixo.
<pre>
opensipsdbctl create opensips
</pre>

O sistema irá lhe perguntar algumas coisas, responda Y (sim) para todas para que ele instale todas as tabelas, não usaremos todas elas, mas desta forma você fica com praticamente tudo criado para o caso de uma expansão dos recursos.

===Instalando o RTP Proxy===
<pre>
cd /usr/src/
wget -c http://b2bua.org/chrome/site/rtpproxy-1.2.1.tar.gz
tar -xzvf rtpproxy-1.2.1.tar.gz
cd rtpproxy-1.2.1
./configure
make
make install
groupadd rtpproxy
useradd -d /var/run/rtpproxy -s /bin/true -g rtpproxy rtpproxy
mkdir /var/log/rtpproxy
mkdir /var/run/rtpproxy
chown -R rtpproxy.rtpproxy /var/log/rtpproxy
chown -R rtpproxy.rtpproxy /var/run/rtpproxy
</pre>

====Arquivo de inicialização====
'''/etc/init.d/rtpproxy'''
<pre>
#!/bin/bash
#
# Este script e de autoria de Mike Tesliuk
# qualquer falha no mesmo por favor informe
# atraves do email mike (a) tesliuk.com
#
### BEGIN INIT INFO
# Provides: rtpproxy
# Required-Start: $syslog $network $local_fs $time
# Required-Stop: $syslog $network $local_fs
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start the RTPPROXY server
# Description: Start the RTPPROXY server
### END INIT INFO

PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin
USELOG=1
USER=rtpproxy
# Altere o ip abaixo para o ip de seu sistema
IPADDR="10.254.254.6"

. /lib/lsb/init-functions

start(){
echo "Iniciando RTP PROXY "
if [ -z $(pidof rtpproxy) ]; then
if [ "${USELOG}" = "1" ]; then
echo "Iniciando com LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /var/log/rtpproxy/rtpproxy.log &
else
echo "Iniciando sem LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /dev/null
fi

if [ -n $(pidof rtpproxy) ]; then
echo "START OK"
fi
else
echo "Processo ja em execucao"
fi
}

stop(){

if [ -z $(pidof rtpproxy) ]; then
echo "Processo nao encontrado"
else
kill -9 $(pidof rtpproxy)
if [ -n $(pidof rtpproxy) ]; then
echo "STOP OK"
else
echo "Falha em realizar stop do servico"
fi

fi
}

case $1 in
start)
start
;;
stop)
stop
;;
restart)
stop
start

;;
*)
echo "Utilize: stop | start | restart"
;;
esac

</pre>

Vamos dar permissao e colocar na inicialização
chmod +x /etc/init.d/rtpproxy
update-rc.d rtpproxy defaults
/etc/init.d/rtpproxy start

===Criando o arquivo opensips.cfg===
O arquivo opensips.cfg é a onde a coisa toda acontece para o opensips, claro que ele dependerá de informações que estarão no banco de dados, mas é onde criamos todas as nossas rotas e validações.

<pre>
####### Global Parameters #########
debug=3
log_stderror=no
log_facility=LOG_LOCAL0

fork=yes
children=4

/* Descomente as linhas abaixo para ativar o debug */
#debug=7
#fork=no
#log_stderror=yes

/* Comente a linha abaixo para ativar a descoberta automatica de enderecos locais
, isso significa que o sistema ira verificar todos os ips ativos e hosts e entao ativara
o protocolo para todos eles */
auto_aliases=no

/* Defina aqui o ip a ser utilizado */
listen=udp:10.254.254.6:5060 # Altere este IP para o seu ambiente

/* Nao usaremos sip por tcp nem tls neste script */
disable_tcp=yes

disable_tls=yes

####### Secao de modulos ########

#set module path
mpath="/usr//lib64/opensips/modules/"

loadmodule "signaling.so"
loadmodule "sl.so"
loadmodule "tm.so"
modparam("tm", "fr_timer", 5)
modparam("tm", "fr_inv_timer", 30)
modparam("tm", "restart_fr_on_each_reply", 0)
modparam("tm", "onreply_avp_mode", 1)

loadmodule "rr.so"
/* do not append from tag to the RR (no need for this script) */
modparam("rr", "append_fromtag", 0)

loadmodule "maxfwd.so"
loadmodule "sipmsgops.so"
loadmodule "mi_fifo.so"
modparam("mi_fifo", "fifo_name", "/tmp/opensips_fifo")
modparam("mi_fifo", "fifo_mode", 0666)

loadmodule "db_mysql.so"

loadmodule "uri.so"
modparam("uri", "use_uri_table", 0)

loadmodule "usrloc.so"
modparam("usrloc", "nat_bflag", "FLB_NATB")
modparam("usrloc", "db_mode", 2)
modparam("usrloc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "registrar.so"
modparam("registrar", "tcp_persistent_flag", "TCP_PERSISTENT")

/* Descomente a linha abaixo para nao permitir mais de 10 contatos por conta */
#modparam("registrar", "max_contacts", 10)

loadmodule "acc.so"
/* Quais eventos deverao ser registrados ? */
modparam("acc", "early_media", 0)
modparam("acc", "report_cancels", 0)
/* por padrao nos nao ajustamos a direcao em requisicoes sequencias,
se voce deseja usar este recurso tenha certeza de ativar o "appen_fromtag"
para o modulo "rr" */
modparam("acc", "detect_direction", 0)
modparam("acc", "failed_transaction_flag", "FLT_ACCFAILED")
/* Gatilhos para accounting (flags) */
modparam("acc", "log_flag", "FLT_ACC")
modparam("acc", "log_missed_flag", "FLT_ACCMISSED")
modparam("acc", "log_extra",
"src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd")
modparam("acc", "db_flag", "FLT_ACC")
modparam("acc", "db_missed_flag", "FLT_ACCMISSED")
modparam("acc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("acc", "db_extra", "src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd" )

loadmodule "auth.so"
loadmodule "auth_db.so"
modparam("auth_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("auth_db", "calculate_ha1", yes)
modparam("auth_db", "password_column", "password")
modparam("auth_db", "load_credentials", "")

loadmodule "permissions.so"
modparam("permissions", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "alias_db.so"
modparam("alias_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "presence.so"
modparam("presence", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

#loadmodule "presence_xml.so"

loadmodule "dialog.so"
modparam("dialog", "db_mode", 2)
modparam("dialog", "db_url","mysql://opensips:opensipsrw@localhost/opensips")
modparam("dialog", "dlg_match_mode", 1)
#modparam("dialog", "default_timeout", 60)

loadmodule "siptrace.so"
modparam("siptrace", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("siptrace", "trace_flag", 22)
modparam("siptrace", "traced_user_avp", "$avp(s:traceuser)")

loadmodule "nathelper.so"
modparam("nathelper", "natping_interval", 30)
modparam("nathelper", "ping_nated_only", 1)
modparam("nathelper", "sipping_bflag", "FLB_NATSIPPING")
modparam("nathelper", "sipping_from", "sip:pinger@10.254.254.6") # Altere o ip para o ip do servidor
modparam("nathelper|registrar", "received_avp", "$avp(RECEIVED)")

loadmodule "rtpproxy.so"
modparam("rtpproxy", "rtpproxy_sock", "udp:127.0.0.1:7722")

####### Logica de roteamento ########

route {

if (!mf_process_maxfwd_header("3")) {
send_reply("483","looping");
exit;
}

xlog("REQUISICAO RECEBIDA, ENVIANDO PARA REQINIT");
# Checagem inicial por requisicao
route(REQINIT);

xlog("ENVIANDO PARA NAT");
# Deteccao de nat
route(NAT);

xlog("ENVIANDO PARA WITHINDLG");
# Gerenciando requisicaoes com dialog
route(WITHINDLG);

# Manipulando requisicoes iniciais (nao consta To tag)

# Processando CANCEL

if(is_method("CANCEL")){
xlog("METHOD CANCEL");
if(t_check_trans()){
t_relay();
}
exit;
}

t_check_trans();

# Enviando para autenticacao
xlog("ENVIANDO PARA AUTENTICACAO");
route(AUTH);

# gravando rota para formacao dos dialogs (caso sejam roteados)
# removemos qualquer cabecalho de rota pre carregado
remove_hf("Route");
if(is_method("INVITE|SUBSCRIBE")){
xlog("METHOD INVITE OU SIBSCRIBE");
record_route();
}

# Contabilizando (acc) INVITES
if(is_method("INVITE")){
xlog("METHOD INVITE, FAZENDOA ACC");
setflag(FLT_ACC);
}

# Enviando chamada para destinos externos
xlog("ENVIANDO PARA SIPOUT");
route(SIPOUT);

# Requisicoes para dominio local

# Roteando requisicoes de PRESENCE
xlog("ENVIANDO PARA PRESENCE");

route(PRESENCE);

# Gerenciando pedidos de registro
xlog("ENVIANDO PARA REGISTRAR");
route(REGISTRAR);

if($ru==""){
xlog("ru --> vazio");
# Requisicao sem usuario na RURI
sl_send_reply("484", "Address Incomplete");
}

# Enviando requisicao para PSTN
xlog("ENVIANDO PARA PSTN");
route(PSTN);

# Salvando informacao de quem originou a chamad
$avp(callee)=$rU;
xlog("ENVIANDO PARA DISPATCH PSTN");
route(FSDISPATCH);

# Servico de localizacao de usuario
route(LOCATION);

# Efetuando o relay (encaminhamento)
route(RELAY);

}

route[RELAY] {
if(check_route_param("nat=yes")){
setbflag(FLB_NATB);
}

if(isflagset(FLT_NATS) || isbflagset(FLB_NATB)){
#route(RTPPROXY);
}

# if(is_method("INVITE")){
# t_on_reply("REPLY_ONE");
# t_on_failure("FAIL_ONE");
# }

xlog("AQUI TENTAMOS ENVIAR A CHAMADA $fU $tU");
if(!t_relay()){
xlog("FALHA EM ENVIAR A CHAMADA, NAO FOI POSSIVEL FAZER O RELAY");
sl_reply_error();
}
xlog("CHAMADA FOI ENVIADA AQUI, QUAL O ERRO ENTAO");

exit;
}

route[REQINIT] {
if(!mf_process_maxfwd_header("10")){
sl_send_reply("483", "Too Many Hops");
exit;
}

}

route[WITHINDLG] {
if(has_totag()){
if(loose_route()){
if(is_method("BYE")){
setflag(FLT_ACC);
setflag(FLT_ACCFAILED);
}
route(RELAY);
}else{
if(is_method("SUBSCRIBE") && uri==myself) {
# requisicao de subscribe pre-estabelecida
route(PRESENCE);
exit;
}

if(is_method("ACK")){
if(t_check_trans()){
t_relay();
exit;
}
}else{
# ACK para transacao nao encontrada, ignoramos...
exit;

}

sl_send_reply("404", "Not Here");

}
exit;
}
}

route[REGISTRAR] {

if(is_method("REGISTER")){
if(isflagset(FLT_NATS)){
setbflag(FLB_NATB);
}

if(!save("location")){
sl_reply_error();
}

exit;
}

}

route[LOCATION] {

alias_db_lookup("dbaliases");
if(!lookup("location")){
switch($rc) {
case -1:
case -3:
t_newtran();
t_reply("404","Not Found");
exit;
case -2:
sl_send_reply("405", "Method Not Allowed");
exit;
}
}

if(is_method("INVITE")){
setflag(FLT_ACCMISSED);
}

}

route[PRESENCE] {
if(!is_method("PUBLISH|SUBSCRIBE")){
return;
}

if(!t_newtran()){
sl_reply_error();
exit;
}

if(is_method("PUBLISH")){
handle_publish();
}else if(is_method("SUBSCRIBE")){
handle_subscribe();
}
exit;

}

route[AUTH]{
xlog("PEDIDO DE AUTENTICACAO");
if(is_method("REGISTER")){
# atentica pedidos de registro
if(!www_authorize("", "subscriber")){
www_challenge("", "0");
exit;
}

if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if(route(FSINBOUND)){
return;
}

if(check_source_address("0")){
return;
}

if(from_uri==myself){
if(!proxy_authorize("", "subscriber")){
proxy_challenge("","0");
exit;
}

if(is_method("PUBLISH")){
if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if($au!=$fU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}
}

# Validamos (autenticamos) o usuario
consume_credentials();
}else{

# usuario nao e local, vamos negar
if(!uri==myself){
sl_send_reply("403", "Not relaying");
exit;
}
}
}

return;
}

route[NAT] {
force_rport();
if(nat_uac_test("19")){
if(method=="REGISTER"){
fix_nated_register();
}else{
fix_nated_contact();
}
setflag(FLT_NATS);
}

return;
}

route[RTPPROXY] {
if(is_method("BYE")){
unforce_rtp_proxy();
}else if(is_method("INVITE")){
engage_rtp_proxy();
}

if(!has_totag()){

if(!check_route_param("nat=yes")){
add_rr_param(";nat=yes");
xlog("NAT yes NAO ENCONTRADO");
}
}

return;
}

route[SIPOUT]{
if(!uri==myself){
append_hf("P-hint: outbound\r\n");
route(RELAY);
}
}

route[PSTN]{
# neste caso apenas para exemplificar um uso simples
# vamos fazer o redirecionamento par ao asterisk
# realizar a dicagem da chamada

if(!($rU=~"^(\+|00)[1-9][0-9]{3,20}$"))
return;

## a regra acima aceita para discagem externa qualquer numero
# comecado com 00 ou +
#

if(from_uri!=myself){
sl_send_reply("403", "Not Allowed");
exit;
}

$ru = "sip:" + $rU + "@" + "10.254.254.6:5090";
xlog("NOVO DESTINO: $ru");
route(RELAY);
exit;

}

route[XMLRPC]{
# nao vamos implementar esta funcionalidade
return;
}

route[FSINBOUND] {
# verificar para validar o ip do asterisk:porta
# se bater , responder com return 1;
if($si=="10.254.254.6" && $sp=="5090"){
return(1);
}else{
return(-1);
}
}

route[FSDISPATCH] {

if(!is_method("INVITE")){
return;
}

if(route(FSINBOUND)){
return;
}

xlog("CAIMOS NO SWITCH, VAMOS LOCALIZAR O PERFIL DA CHAMADA $rU");

if($rU =~ "^41$"){
xlog("SWITCH expressa comeca e termina em 41");
#regra de menu de voicemail, apenas
# usuarios autenticados
if($au==""){
sl_send_reply("403", "Not Allowed");
exit;
}

$rU = "vma-" + $au;
}else if($rU =~ "^441[0-9][0-9]$"){
xlog("SWTICH OPCA 441XX ");
# numero discado comeca com 441 seguido de dois digitos
# chamada direta para inbox do voicemail
strip(2);
route(FSVBOX);
}else if($rU =~ "^433[01][0-9][0-9]$"){
xlog("SWITCH OPCAO 433[01]XX");
# numero comecado em 443, seguido de 0 ou 1, mais dois digitos
# sistema de conferencia
strip(2);
}else if($rU =~ "^45[0-9]+$"){
xlog("SWTICH OPCAO 45X.");
#numero comecado com 45, seguindo de numeros;
strip(2);
}else{
xlog("OPCAO DEFAULT DO SWITCH");
# usuario offline, enviando para voicemail
if(!registered("location")){
route(FSVBOX);
exit;
}

# usuario online, fazendo bridging
xlog("USUARIO ESTA ONLINE VAMOS FAZER BRIDGE");
prefix("kb-");
if(is_method("INVITE")){
t_on_failure("FAIL_FSVBOX");
}
}
route(FSRELAY);
exit;
}

route[FSVBOX]{
xlog("ENVIANDO PARA FSVBOX");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($rU =~ "^441[0-9][0-9]"){
strip(2);
}
prefix("vm-");
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;
}

route[FSRELAY] {
xlog("ENVIANDO PARA FSRELAY");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;

}

branch_route[BRANCH_ONE]{
xlog("new branch at $ru");
}

onreply_route[REPLY_ONE]{
xlog("Incoming reply");
if((isflagset(FLT_NATS) || isbflagset(FLB_NATB) && status =~ "(183)|(2[0-9][0-9])")){
#rtpproxy_offer();

}
if(isbflagset(FLB_NATB)){
fix_nated_contact();
}

}

failure_route[FAIL_ONE]{
xlog("FAILURE ROUTE FAIL_ONE");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

}

failure_route[FAIL_FSVBOX]{
xlog("FAILURE ROUTE FAIL_FSVBOX");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

if(t_check_status("486|408|480")){
$rU = $avp(callee);
$var(newbranch) = 1;
route(FSVBOX);
}
}

</pre>

==Testes com Opensips (registro)==

Antes de podermos testar precisamos iniciar o serviço, no momento estamos com ele operando em modo debug, então a inicialização deve ser realizada com o comando abaixo
/etc/init.d/opensips debug

Abra uma nova sessão no servidor e então vamos criar os usuários
opensipsctl add 101 101
opensipsctl add 102 102
opensipsctl add 103 103

usuario 101 com senha 101 e assim por diante

Faça a onexão com seu softphone, aqui para testes utilizei o jitsi e o zoiper, neste momento vamos apenas fazer o registro do usuário para testar a autenticação, se você tentar realizar uma discagem não funcionará pois neste caso o processo depende do Asterisk que ainda não está configurado, vamos dar inicio nesta configuração agora.

==Asterisk==
Não vamos dar muitos detalhes da instalação do asterisk aqui, a ideia é simplesmente ter o mesmo funcionando da forma que necessitamos.
apt-get install asterisk

Após a instalação , abra o arquivo /etc/asterisk/sip.conf, localize a linha '''udpbindaddr=0.0.0.0''' e altere para '''udpbindaddr=0.0.0.0:5090''' , depois ao fim do arquivo adicione.
<pre>
[opensips]
type=peer
host=10.254.254.6
port=5060
qualify=yes
context=opensips
insecure=port,invite
canreinvite=no
</pre>

Agora abra o arquivo '''/etc/asterisk/extensions.conf''' , crie no fim do arquivo a seguinte entrada.
<pre>
[opensips]

exten => _kb-1XX,1,NoOp(CHAMADA INTERNA - FAZER BRIDGE - ${CALLERID(num)} ${EXTEN:3})
same => n,Dial(SIP/opensips/${EXTEN:3})
same => n,Goto(opensips,vm-${EXTEN:3},1)
same => n,Hangup()

exten => _vm-1XX,1,NoOp(CHAMADA PARA VOICEMAIL)
same => n,Voicemail(${EXTEN:3}@default)
same => n,Hangup()

exten => _vma-1XX,1,NoOp(CHAMADA PARA VOICEMAIL - ADMINISTRATIVO)
same => n,VoicemailMain(${EXTEN:4}@default)
same => n,Hangup()

exten => _3[01]XX,1,NoOp(CHAMADA PARA CONFERENCIA)
same => n,Answer()
same => n,ConfBridge(${EXTEN},cM1)
same => n,Hangup()

exten => _00.,1,NoOp(CHAMADA PARA PSTN)
same => n,Wait(2)
same => n,Answer()
same => n,Wait(1)
same => n,PlayBack(tt-monkeys)
same => n,Hangup()

exten => h,1,Hangup()

</pre>

Finalmente precisamos criar as entradas do voicemail, para isso altere o arquivo '''/etc/asterisk/voicemail.conf''' localize o contexto '''[default]''' e então adicione as entradas para seu voicemail, segue dois exemplos abaixo.
<pre>
101 => 123123,Mike Tesliuk
102 => 123123,Mike Tesliuk 2
</pre>

Feito isso, faça um restart no asterisk
/etc/init.d/asterisk restart

Agora você ja poderá fazer os testes, basicamente criamos as seguintes situações para serem testadas.

*1 Autenticação de usuários
*2 Chamada entre usuários
*3 Encaminhamento para caixa postal
*4 Acesso a caixa postal
*5 Acesso a conferência

OpenSIPs e Asterisk

2021-04-15T22:55:38Z

Admin:

{| class="wikitable"
|-
|Precisando de recursos de númeração para fazer seus testes ? contrate conosco em [http://www.brdvoz.com.br|BRDVoz]
|-
|}

<table>
<tr><td style="background-color: red;"><b><font color=white> Falta realizar os ajustes / testes para o NAT no mais esta tudo funcionado adequadamente a principio </font></b></td></tr>
</table>

Este tutorial é baseado em um tutorial similar porém utilizando Kamailio e Freeswtich, se quiser verificar o tutorial original acesse http://kb.asipto.com/freeswitch:kamailio-3.1.x-freeswitch-1.0.6d-sbc.

Para esta implementação utilizamos Debian 7.0 amd64 , OpenSIPS 1.9 e Asterisk 1.8.23

==Funcionalidades==
Este tutorial tem por objetivo atingir as seguintes funcionalidades.
*Autenticação de usuário
*Registro de usuário
*Localização de usuário (encaminhamento de chamadas)
*Roteamento de chamadas

Através do Asterisk estenderemos estas funcionalidades agregando.
*Correio de voz (Voicemail)
*Conferencia
*SBC ( Pode ser utilizado para transcoding, esconder topologia, play de mensagens e tarifação )
*Outros serviços de media (Anuncios, Ura's e coisas do tipo)

==Definições==
Para um melhor entendimento da solução vamos expor aqui algumas definições de nosso sistema.
*Usuários locais terão ramais com 3 digitos (ex: 101, 102, 103)
*Identidade do correio de voz será o mesmo do ramal
*Serviços de media (acesso a voicemail e outros) receberão rotas de 4 digitos
*Opensips e Asterisk utilizarão o mesmo servidor (Neste caso IP: 10.254.254.6)
*Os serviços rodarão nas portas 5060 (opensips) , 5090 (Asterisk)

==Funcionamento==
A autenticação do usuário será realizada pelo OpenSIPs, quando uma chamada é autenticada então ela serguirá:
*Se o usuário de destino não está online a chamada será enviada para o Asterisk para função de correio de voz
*Se o usuário está online a chamada será encaminhada para o Asterisk, dest forma é possivel acionar funcionalidades como anuncios, definição de tempo de chamada, forçar codecs e outras funcionalidades.
*Asterisk envia a chamada novamente para o OpenSIPs que verificará no location e entregará a chamada para o usuário.
*Se a chamada não for atendida o Opensips irá re-encaminhar para o Asterisk direcionando para função de voicemail

==OpenSIPs==
Vamos iniciar o processo de instalação com o OpenSIPs, siga os procedimentos abaixo para evitar qualquer dificuldade.

===Dependencias===
Execute o comando abaixo para instalar todas as dependencias necessárias
<pre>
apt-get install gcc make libncurses5-dev libnewt-dev libxml2-dev unixodbc \
unixodbc-dev libmysqlclient15-dev libxmlrpc-c3-dev libexpat1-dev zlib1g-dev \
m4 bison flex libpcre3-dev mysql-server vim apache2-mpm-prefork libapache2-mod-php5 \
php5-mysql php5-xmlrpc php-pear ngrep g++ libjpeg62-dev libssl-dev
</pre>

Durante a instalação o sistema irá lhe perguntar a senha de root para o servidor MySQL é importante que você se lembre da mesma posteriormente pois utilizaremos a mesma.

===Compilando o OpenSIPs===
Para manter um padrão onde os dados estao vamos utilizar o diretório /usr/src/ para o download de código fonte.

cd /usr/src/
wget -c http://opensips.org/pub/opensips/1.9.1/src/opensips-1.9.1_src.tar.gz
tar -xzvf opensips-1.9.1_src.tar.gz
cd opensips-1.9.1-tls/
make menuconfig

Neste ponto o sistema irá abrir uma tela com algumas opções para selecionar, Acesse a primeira opção do menu, no submenu acesse a segunda opção ( Configure excluded modules ), selecione os módulos db_mysql , dialplan , mi_xmlrpc , presence e presence_xml

Agora volte ao submenu, e selecione a opção Save Changes, volte para o menu principal e selecione '''Compile and Install OpenSips''' , deixe que o sistema execute suas funções.

Ao finalizar a compilação você retornará ao menu, va na opção '''Exit and Save all changes'''

===Preparando a Configuração===

Antes de darmos inicio ao arquivo de configuração, vamos ajustar algumas questões, o opensips instala os arquivos (se voce nao alterar o parametro) em /usr, consequentemente as configurações ficam em /usr/etc , eu por padrão faço um link para o diretório /etc, assim acesso as configurações em /etc/opensips

ln -s /usr/etc/opensips /etc/

No caso do debian o script de inicialização utiliza um arquivo extra de configuração
cp packaging/debian/opensips.default /etc/default/opensips

Para o script de inicialização execute o comando abaixo
cp packaging/debian/opensips.init /etc/init.d/opensips
chmod +x /etc/init.d/opensips
update-rc.d opensips defaults

Edite o arquivo /etc/default/opensips , a altere o parametro '''RUN_OPENSIPS''' para yes

Você pode notar que no arquivo é mensionado o usuário de execução do opensips como opensips, então vamos ter de criar este usuário ( e grupo )

groupadd opensips
mkdir /var/run/opensips
useradd -d /var/run/opensips/ -s /bin/false -g opensips opensips
chown -R opensips.opensips /var/run/opensips

===Configurando o opensipsctl===
O opensipsctl (e opensipsdbctl) utilizam o arquivo de configuração /etc/opensips/opensipsctlrc, abaixo segue o conteúdo do arquivo. (Sugiro que você faça um backup dos arquivos originais para ter uma copia, existem parametros que você pode estudar depois).

<pre>
DBENGINE=MYSQL
DBHOST=localhost
DBNAME=opensips
DBRWUSER=opensips
DBRWPW="opensipsrw"
SIP_DOMAIN=10.254.254.6 ### caso voce esteja usando outro ip altere aqui

DBROOTUSER="root"
INSTALL_EXTRA_TABLES=ask
ALIASES_TYPE="DB"
MI_CONNECTOR=FIFO:/tmp/opensips_fifo
# VERIFY_ACL=1
# ACL_GROUPS="local ld int voicemail free-pstn"
# VERBOSE=1
# STORE_PLAINTEXT_PW=0
# NOHLPRINT=1
PID_FILE=/var/run/opensips/opensips.pid
</pre>

===Criando o banco de dados===
Agora que temos nosso arquivo configurado vamos fazer a criação do banco de dados, execute o comando abaixo.
<pre>
opensipsdbctl create opensips
</pre>

O sistema irá lhe perguntar algumas coisas, responda Y (sim) para todas para que ele instale todas as tabelas, não usaremos todas elas, mas desta forma você fica com praticamente tudo criado para o caso de uma expansão dos recursos.

===Instalando o RTP Proxy===
<pre>
cd /usr/src/
wget -c http://b2bua.org/chrome/site/rtpproxy-1.2.1.tar.gz
tar -xzvf rtpproxy-1.2.1.tar.gz
cd rtpproxy-1.2.1
./configure
make
make install
groupadd rtpproxy
useradd -d /var/run/rtpproxy -s /bin/true -g rtpproxy rtpproxy
mkdir /var/log/rtpproxy
mkdir /var/run/rtpproxy
chown -R rtpproxy.rtpproxy /var/log/rtpproxy
chown -R rtpproxy.rtpproxy /var/run/rtpproxy
</pre>

====Arquivo de inicialização====
'''/etc/init.d/rtpproxy'''
<pre>
#!/bin/bash
#
# Este script e de autoria de Mike Tesliuk
# qualquer falha no mesmo por favor informe
# atraves do email mike (a) tesliuk.com
#
### BEGIN INIT INFO
# Provides: rtpproxy
# Required-Start: $syslog $network $local_fs $time
# Required-Stop: $syslog $network $local_fs
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start the RTPPROXY server
# Description: Start the RTPPROXY server
### END INIT INFO

PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin
USELOG=1
USER=rtpproxy
# Altere o ip abaixo para o ip de seu sistema
IPADDR="10.254.254.6"

. /lib/lsb/init-functions

start(){
echo "Iniciando RTP PROXY "
if [ -z $(pidof rtpproxy) ]; then
if [ "${USELOG}" = "1" ]; then
echo "Iniciando com LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /var/log/rtpproxy/rtpproxy.log &
else
echo "Iniciando sem LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /dev/null
fi

if [ -n $(pidof rtpproxy) ]; then
echo "START OK"
fi
else
echo "Processo ja em execucao"
fi
}

stop(){

if [ -z $(pidof rtpproxy) ]; then
echo "Processo nao encontrado"
else
kill -9 $(pidof rtpproxy)
if [ -n $(pidof rtpproxy) ]; then
echo "STOP OK"
else
echo "Falha em realizar stop do servico"
fi

fi
}

case $1 in
start)
start
;;
stop)
stop
;;
restart)
stop
start

;;
*)
echo "Utilize: stop | start | restart"
;;
esac

</pre>

Vamos dar permissao e colocar na inicialização
chmod +x /etc/init.d/rtpproxy
update-rc.d rtpproxy defaults
/etc/init.d/rtpproxy start

===Criando o arquivo opensips.cfg===
O arquivo opensips.cfg é a onde a coisa toda acontece para o opensips, claro que ele dependerá de informações que estarão no banco de dados, mas é onde criamos todas as nossas rotas e validações.

<pre>
####### Global Parameters #########
debug=3
log_stderror=no
log_facility=LOG_LOCAL0

fork=yes
children=4

/* Descomente as linhas abaixo para ativar o debug */
#debug=7
#fork=no
#log_stderror=yes

/* Comente a linha abaixo para ativar a descoberta automatica de enderecos locais
, isso significa que o sistema ira verificar todos os ips ativos e hosts e entao ativara
o protocolo para todos eles */
auto_aliases=no

/* Defina aqui o ip a ser utilizado */
listen=udp:10.254.254.6:5060 # Altere este IP para o seu ambiente

/* Nao usaremos sip por tcp nem tls neste script */
disable_tcp=yes

disable_tls=yes

####### Secao de modulos ########

#set module path
mpath="/usr//lib64/opensips/modules/"

loadmodule "signaling.so"
loadmodule "sl.so"
loadmodule "tm.so"
modparam("tm", "fr_timer", 5)
modparam("tm", "fr_inv_timer", 30)
modparam("tm", "restart_fr_on_each_reply", 0)
modparam("tm", "onreply_avp_mode", 1)

loadmodule "rr.so"
/* do not append from tag to the RR (no need for this script) */
modparam("rr", "append_fromtag", 0)

loadmodule "maxfwd.so"
loadmodule "sipmsgops.so"
loadmodule "mi_fifo.so"
modparam("mi_fifo", "fifo_name", "/tmp/opensips_fifo")
modparam("mi_fifo", "fifo_mode", 0666)

loadmodule "db_mysql.so"

loadmodule "uri.so"
modparam("uri", "use_uri_table", 0)

loadmodule "usrloc.so"
modparam("usrloc", "nat_bflag", "FLB_NATB")
modparam("usrloc", "db_mode", 2)
modparam("usrloc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "registrar.so"
modparam("registrar", "tcp_persistent_flag", "TCP_PERSISTENT")

/* Descomente a linha abaixo para nao permitir mais de 10 contatos por conta */
#modparam("registrar", "max_contacts", 10)

loadmodule "acc.so"
/* Quais eventos deverao ser registrados ? */
modparam("acc", "early_media", 0)
modparam("acc", "report_cancels", 0)
/* por padrao nos nao ajustamos a direcao em requisicoes sequencias,
se voce deseja usar este recurso tenha certeza de ativar o "appen_fromtag"
para o modulo "rr" */
modparam("acc", "detect_direction", 0)
modparam("acc", "failed_transaction_flag", "FLT_ACCFAILED")
/* Gatilhos para accounting (flags) */
modparam("acc", "log_flag", "FLT_ACC")
modparam("acc", "log_missed_flag", "FLT_ACCMISSED")
modparam("acc", "log_extra",
"src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd")
modparam("acc", "db_flag", "FLT_ACC")
modparam("acc", "db_missed_flag", "FLT_ACCMISSED")
modparam("acc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("acc", "db_extra", "src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd" )

loadmodule "auth.so"
loadmodule "auth_db.so"
modparam("auth_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("auth_db", "calculate_ha1", yes)
modparam("auth_db", "password_column", "password")
modparam("auth_db", "load_credentials", "")

loadmodule "permissions.so"
modparam("permissions", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "alias_db.so"
modparam("alias_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "presence.so"
modparam("presence", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

#loadmodule "presence_xml.so"

loadmodule "dialog.so"
modparam("dialog", "db_mode", 2)
modparam("dialog", "db_url","mysql://opensips:opensipsrw@localhost/opensips")
modparam("dialog", "dlg_match_mode", 1)
#modparam("dialog", "default_timeout", 60)

loadmodule "siptrace.so"
modparam("siptrace", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("siptrace", "trace_flag", 22)
modparam("siptrace", "traced_user_avp", "$avp(s:traceuser)")

loadmodule "nathelper.so"
modparam("nathelper", "natping_interval", 30)
modparam("nathelper", "ping_nated_only", 1)
modparam("nathelper", "sipping_bflag", "FLB_NATSIPPING")
modparam("nathelper", "sipping_from", "sip:pinger@10.254.254.6") # Altere o ip para o ip do servidor
modparam("nathelper|registrar", "received_avp", "$avp(RECEIVED)")

loadmodule "rtpproxy.so"
modparam("rtpproxy", "rtpproxy_sock", "udp:127.0.0.1:7722")

####### Logica de roteamento ########

route {

if (!mf_process_maxfwd_header("3")) {
send_reply("483","looping");
exit;
}

xlog("REQUISICAO RECEBIDA, ENVIANDO PARA REQINIT");
# Checagem inicial por requisicao
route(REQINIT);

xlog("ENVIANDO PARA NAT");
# Deteccao de nat
route(NAT);

xlog("ENVIANDO PARA WITHINDLG");
# Gerenciando requisicaoes com dialog
route(WITHINDLG);

# Manipulando requisicoes iniciais (nao consta To tag)

# Processando CANCEL

if(is_method("CANCEL")){
xlog("METHOD CANCEL");
if(t_check_trans()){
t_relay();
}
exit;
}

t_check_trans();

# Enviando para autenticacao
xlog("ENVIANDO PARA AUTENTICACAO");
route(AUTH);

# gravando rota para formacao dos dialogs (caso sejam roteados)
# removemos qualquer cabecalho de rota pre carregado
remove_hf("Route");
if(is_method("INVITE|SUBSCRIBE")){
xlog("METHOD INVITE OU SIBSCRIBE");
record_route();
}

# Contabilizando (acc) INVITES
if(is_method("INVITE")){
xlog("METHOD INVITE, FAZENDOA ACC");
setflag(FLT_ACC);
}

# Enviando chamada para destinos externos
xlog("ENVIANDO PARA SIPOUT");
route(SIPOUT);

# Requisicoes para dominio local

# Roteando requisicoes de PRESENCE
xlog("ENVIANDO PARA PRESENCE");

route(PRESENCE);

# Gerenciando pedidos de registro
xlog("ENVIANDO PARA REGISTRAR");
route(REGISTRAR);

if($ru==""){
xlog("ru --> vazio");
# Requisicao sem usuario na RURI
sl_send_reply("484", "Address Incomplete");
}

# Enviando requisicao para PSTN
xlog("ENVIANDO PARA PSTN");
route(PSTN);

# Salvando informacao de quem originou a chamad
$avp(callee)=$rU;
xlog("ENVIANDO PARA DISPATCH PSTN");
route(FSDISPATCH);

# Servico de localizacao de usuario
route(LOCATION);

# Efetuando o relay (encaminhamento)
route(RELAY);

}

route[RELAY] {
if(check_route_param("nat=yes")){
setbflag(FLB_NATB);
}

if(isflagset(FLT_NATS) || isbflagset(FLB_NATB)){
#route(RTPPROXY);
}

# if(is_method("INVITE")){
# t_on_reply("REPLY_ONE");
# t_on_failure("FAIL_ONE");
# }

xlog("AQUI TENTAMOS ENVIAR A CHAMADA $fU $tU");
if(!t_relay()){
xlog("FALHA EM ENVIAR A CHAMADA, NAO FOI POSSIVEL FAZER O RELAY");
sl_reply_error();
}
xlog("CHAMADA FOI ENVIADA AQUI, QUAL O ERRO ENTAO");

exit;
}

route[REQINIT] {
if(!mf_process_maxfwd_header("10")){
sl_send_reply("483", "Too Many Hops");
exit;
}

}

route[WITHINDLG] {
if(has_totag()){
if(loose_route()){
if(is_method("BYE")){
setflag(FLT_ACC);
setflag(FLT_ACCFAILED);
}
route(RELAY);
}else{
if(is_method("SUBSCRIBE") && uri==myself) {
# requisicao de subscribe pre-estabelecida
route(PRESENCE);
exit;
}

if(is_method("ACK")){
if(t_check_trans()){
t_relay();
exit;
}
}else{
# ACK para transacao nao encontrada, ignoramos...
exit;

}

sl_send_reply("404", "Not Here");

}
exit;
}
}

route[REGISTRAR] {

if(is_method("REGISTER")){
if(isflagset(FLT_NATS)){
setbflag(FLB_NATB);
}

if(!save("location")){
sl_reply_error();
}

exit;
}

}

route[LOCATION] {

alias_db_lookup("dbaliases");
if(!lookup("location")){
switch($rc) {
case -1:
case -3:
t_newtran();
t_reply("404","Not Found");
exit;
case -2:
sl_send_reply("405", "Method Not Allowed");
exit;
}
}

if(is_method("INVITE")){
setflag(FLT_ACCMISSED);
}

}

route[PRESENCE] {
if(!is_method("PUBLISH|SUBSCRIBE")){
return;
}

if(!t_newtran()){
sl_reply_error();
exit;
}

if(is_method("PUBLISH")){
handle_publish();
}else if(is_method("SUBSCRIBE")){
handle_subscribe();
}
exit;

}

route[AUTH]{
xlog("PEDIDO DE AUTENTICACAO");
if(is_method("REGISTER")){
# atentica pedidos de registro
if(!www_authorize("", "subscriber")){
www_challenge("", "0");
exit;
}

if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if(route(FSINBOUND)){
return;
}

if(check_source_address("0")){
return;
}

if(from_uri==myself){
if(!proxy_authorize("", "subscriber")){
proxy_challenge("","0");
exit;
}

if(is_method("PUBLISH")){
if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if($au!=$fU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}
}

# Validamos (autenticamos) o usuario
consume_credentials();
}else{

# usuario nao e local, vamos negar
if(!uri==myself){
sl_send_reply("403", "Not relaying");
exit;
}
}
}

return;
}

route[NAT] {
force_rport();
if(nat_uac_test("19")){
if(method=="REGISTER"){
fix_nated_register();
}else{
fix_nated_contact();
}
setflag(FLT_NATS);
}

return;
}

route[RTPPROXY] {
if(is_method("BYE")){
unforce_rtp_proxy();
}else if(is_method("INVITE")){
engage_rtp_proxy();
}

if(!has_totag()){

if(!check_route_param("nat=yes")){
add_rr_param(";nat=yes");
xlog("NAT yes NAO ENCONTRADO");
}
}

return;
}

route[SIPOUT]{
if(!uri==myself){
append_hf("P-hint: outbound\r\n");
route(RELAY);
}
}

route[PSTN]{
# neste caso apenas para exemplificar um uso simples
# vamos fazer o redirecionamento par ao asterisk
# realizar a dicagem da chamada

if(!($rU=~"^(\+|00)[1-9][0-9]{3,20}$"))
return;

## a regra acima aceita para discagem externa qualquer numero
# comecado com 00 ou +
#

if(from_uri!=myself){
sl_send_reply("403", "Not Allowed");
exit;
}

$ru = "sip:" + $rU + "@" + "10.254.254.6:5090";
xlog("NOVO DESTINO: $ru");
route(RELAY);
exit;

}

route[XMLRPC]{
# nao vamos implementar esta funcionalidade
return;
}

route[FSINBOUND] {
# verificar para validar o ip do asterisk:porta
# se bater , responder com return 1;
if($si=="10.254.254.6" && $sp=="5090"){
return(1);
}else{
return(-1);
}
}

route[FSDISPATCH] {

if(!is_method("INVITE")){
return;
}

if(route(FSINBOUND)){
return;
}

xlog("CAIMOS NO SWITCH, VAMOS LOCALIZAR O PERFIL DA CHAMADA $rU");

if($rU =~ "^41$"){
xlog("SWITCH expressa comeca e termina em 41");
#regra de menu de voicemail, apenas
# usuarios autenticados
if($au==""){
sl_send_reply("403", "Not Allowed");
exit;
}

$rU = "vma-" + $au;
}else if($rU =~ "^441[0-9][0-9]$"){
xlog("SWTICH OPCA 441XX ");
# numero discado comeca com 441 seguido de dois digitos
# chamada direta para inbox do voicemail
strip(2);
route(FSVBOX);
}else if($rU =~ "^433[01][0-9][0-9]$"){
xlog("SWITCH OPCAO 433[01]XX");
# numero comecado em 443, seguido de 0 ou 1, mais dois digitos
# sistema de conferencia
strip(2);
}else if($rU =~ "^45[0-9]+$"){
xlog("SWTICH OPCAO 45X.");
#numero comecado com 45, seguindo de numeros;
strip(2);
}else{
xlog("OPCAO DEFAULT DO SWITCH");
# usuario offline, enviando para voicemail
if(!registered("location")){
route(FSVBOX);
exit;
}

# usuario online, fazendo bridging
xlog("USUARIO ESTA ONLINE VAMOS FAZER BRIDGE");
prefix("kb-");
if(is_method("INVITE")){
t_on_failure("FAIL_FSVBOX");
}
}
route(FSRELAY);
exit;
}

route[FSVBOX]{
xlog("ENVIANDO PARA FSVBOX");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($rU =~ "^441[0-9][0-9]"){
strip(2);
}
prefix("vm-");
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;
}

route[FSRELAY] {
xlog("ENVIANDO PARA FSRELAY");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;

}

branch_route[BRANCH_ONE]{
xlog("new branch at $ru");
}

onreply_route[REPLY_ONE]{
xlog("Incoming reply");
if((isflagset(FLT_NATS) || isbflagset(FLB_NATB) && status =~ "(183)|(2[0-9][0-9])")){
#rtpproxy_offer();

}
if(isbflagset(FLB_NATB)){
fix_nated_contact();
}

}

failure_route[FAIL_ONE]{
xlog("FAILURE ROUTE FAIL_ONE");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

}

failure_route[FAIL_FSVBOX]{
xlog("FAILURE ROUTE FAIL_FSVBOX");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

if(t_check_status("486|408|480")){
$rU = $avp(callee);
$var(newbranch) = 1;
route(FSVBOX);
}
}

</pre>

==Testes com Opensips (registro)==

Antes de podermos testar precisamos iniciar o serviço, no momento estamos com ele operando em modo debug, então a inicialização deve ser realizada com o comando abaixo
/etc/init.d/opensips debug

Abra uma nova sessão no servidor e então vamos criar os usuários
opensipsctl add 101 101
opensipsctl add 102 102
opensipsctl add 103 103

usuario 101 com senha 101 e assim por diante

Faça a onexão com seu softphone, aqui para testes utilizei o jitsi e o zoiper, neste momento vamos apenas fazer o registro do usuário para testar a autenticação, se você tentar realizar uma discagem não funcionará pois neste caso o processo depende do Asterisk que ainda não está configurado, vamos dar inicio nesta configuração agora.

==Asterisk==
Não vamos dar muitos detalhes da instalação do asterisk aqui, a ideia é simplesmente ter o mesmo funcionando da forma que necessitamos.
apt-get install asterisk

Após a instalação , abra o arquivo /etc/asterisk/sip.conf, localize a linha '''udpbindaddr=0.0.0.0''' e altere para '''udpbindaddr=0.0.0.0:5090''' , depois ao fim do arquivo adicione.
<pre>
[opensips]
type=peer
host=10.254.254.6
port=5060
qualify=yes
context=opensips
insecure=port,invite
canreinvite=no
</pre>

Agora abra o arquivo '''/etc/asterisk/extensions.conf''' , crie no fim do arquivo a seguinte entrada.
<pre>
[opensips]

exten => _kb-1XX,1,NoOp(CHAMADA INTERNA - FAZER BRIDGE - ${CALLERID(num)} ${EXTEN:3})
same => n,Dial(SIP/opensips/${EXTEN:3})
same => n,Goto(opensips,vm-${EXTEN:3},1)
same => n,Hangup()

exten => _vm-1XX,1,NoOp(CHAMADA PARA VOICEMAIL)
same => n,Voicemail(${EXTEN:3}@default)
same => n,Hangup()

exten => _vma-1XX,1,NoOp(CHAMADA PARA VOICEMAIL - ADMINISTRATIVO)
same => n,VoicemailMain(${EXTEN:4}@default)
same => n,Hangup()

exten => _3[01]XX,1,NoOp(CHAMADA PARA CONFERENCIA)
same => n,Answer()
same => n,ConfBridge(${EXTEN},cM1)
same => n,Hangup()

exten => _00.,1,NoOp(CHAMADA PARA PSTN)
same => n,Wait(2)
same => n,Answer()
same => n,Wait(1)
same => n,PlayBack(tt-monkeys)
same => n,Hangup()

exten => h,1,Hangup()

</pre>

Finalmente precisamos criar as entradas do voicemail, para isso altere o arquivo '''/etc/asterisk/voicemail.conf''' localize o contexto '''[default]''' e então adicione as entradas para seu voicemail, segue dois exemplos abaixo.
<pre>
101 => 123123,Mike Tesliuk
102 => 123123,Mike Tesliuk 2
</pre>

Feito isso, faça um restart no asterisk
/etc/init.d/asterisk restart

Agora você ja poderá fazer os testes, basicamente criamos as seguintes situações para serem testadas.

*1 Autenticação de usuários
*2 Chamada entre usuários
*3 Encaminhamento para caixa postal
*4 Acesso a caixa postal
*5 Acesso a conferência

OpenSIPs e Asterisk

2021-04-15T22:55:27Z

Admin:

{| class="wikitable"
|-
|Precisando de recursos de númeração para fazer seus testes ? contrate conosco em [http://www.brdvoz.com.br]
|-
|}

<table>
<tr><td style="background-color: red;"><b><font color=white> Falta realizar os ajustes / testes para o NAT no mais esta tudo funcionado adequadamente a principio </font></b></td></tr>
</table>

Este tutorial é baseado em um tutorial similar porém utilizando Kamailio e Freeswtich, se quiser verificar o tutorial original acesse http://kb.asipto.com/freeswitch:kamailio-3.1.x-freeswitch-1.0.6d-sbc.

Para esta implementação utilizamos Debian 7.0 amd64 , OpenSIPS 1.9 e Asterisk 1.8.23

==Funcionalidades==
Este tutorial tem por objetivo atingir as seguintes funcionalidades.
*Autenticação de usuário
*Registro de usuário
*Localização de usuário (encaminhamento de chamadas)
*Roteamento de chamadas

Através do Asterisk estenderemos estas funcionalidades agregando.
*Correio de voz (Voicemail)
*Conferencia
*SBC ( Pode ser utilizado para transcoding, esconder topologia, play de mensagens e tarifação )
*Outros serviços de media (Anuncios, Ura's e coisas do tipo)

==Definições==
Para um melhor entendimento da solução vamos expor aqui algumas definições de nosso sistema.
*Usuários locais terão ramais com 3 digitos (ex: 101, 102, 103)
*Identidade do correio de voz será o mesmo do ramal
*Serviços de media (acesso a voicemail e outros) receberão rotas de 4 digitos
*Opensips e Asterisk utilizarão o mesmo servidor (Neste caso IP: 10.254.254.6)
*Os serviços rodarão nas portas 5060 (opensips) , 5090 (Asterisk)

==Funcionamento==
A autenticação do usuário será realizada pelo OpenSIPs, quando uma chamada é autenticada então ela serguirá:
*Se o usuário de destino não está online a chamada será enviada para o Asterisk para função de correio de voz
*Se o usuário está online a chamada será encaminhada para o Asterisk, dest forma é possivel acionar funcionalidades como anuncios, definição de tempo de chamada, forçar codecs e outras funcionalidades.
*Asterisk envia a chamada novamente para o OpenSIPs que verificará no location e entregará a chamada para o usuário.
*Se a chamada não for atendida o Opensips irá re-encaminhar para o Asterisk direcionando para função de voicemail

==OpenSIPs==
Vamos iniciar o processo de instalação com o OpenSIPs, siga os procedimentos abaixo para evitar qualquer dificuldade.

===Dependencias===
Execute o comando abaixo para instalar todas as dependencias necessárias
<pre>
apt-get install gcc make libncurses5-dev libnewt-dev libxml2-dev unixodbc \
unixodbc-dev libmysqlclient15-dev libxmlrpc-c3-dev libexpat1-dev zlib1g-dev \
m4 bison flex libpcre3-dev mysql-server vim apache2-mpm-prefork libapache2-mod-php5 \
php5-mysql php5-xmlrpc php-pear ngrep g++ libjpeg62-dev libssl-dev
</pre>

Durante a instalação o sistema irá lhe perguntar a senha de root para o servidor MySQL é importante que você se lembre da mesma posteriormente pois utilizaremos a mesma.

===Compilando o OpenSIPs===
Para manter um padrão onde os dados estao vamos utilizar o diretório /usr/src/ para o download de código fonte.

cd /usr/src/
wget -c http://opensips.org/pub/opensips/1.9.1/src/opensips-1.9.1_src.tar.gz
tar -xzvf opensips-1.9.1_src.tar.gz
cd opensips-1.9.1-tls/
make menuconfig

Neste ponto o sistema irá abrir uma tela com algumas opções para selecionar, Acesse a primeira opção do menu, no submenu acesse a segunda opção ( Configure excluded modules ), selecione os módulos db_mysql , dialplan , mi_xmlrpc , presence e presence_xml

Agora volte ao submenu, e selecione a opção Save Changes, volte para o menu principal e selecione '''Compile and Install OpenSips''' , deixe que o sistema execute suas funções.

Ao finalizar a compilação você retornará ao menu, va na opção '''Exit and Save all changes'''

===Preparando a Configuração===

Antes de darmos inicio ao arquivo de configuração, vamos ajustar algumas questões, o opensips instala os arquivos (se voce nao alterar o parametro) em /usr, consequentemente as configurações ficam em /usr/etc , eu por padrão faço um link para o diretório /etc, assim acesso as configurações em /etc/opensips

ln -s /usr/etc/opensips /etc/

No caso do debian o script de inicialização utiliza um arquivo extra de configuração
cp packaging/debian/opensips.default /etc/default/opensips

Para o script de inicialização execute o comando abaixo
cp packaging/debian/opensips.init /etc/init.d/opensips
chmod +x /etc/init.d/opensips
update-rc.d opensips defaults

Edite o arquivo /etc/default/opensips , a altere o parametro '''RUN_OPENSIPS''' para yes

Você pode notar que no arquivo é mensionado o usuário de execução do opensips como opensips, então vamos ter de criar este usuário ( e grupo )

groupadd opensips
mkdir /var/run/opensips
useradd -d /var/run/opensips/ -s /bin/false -g opensips opensips
chown -R opensips.opensips /var/run/opensips

===Configurando o opensipsctl===
O opensipsctl (e opensipsdbctl) utilizam o arquivo de configuração /etc/opensips/opensipsctlrc, abaixo segue o conteúdo do arquivo. (Sugiro que você faça um backup dos arquivos originais para ter uma copia, existem parametros que você pode estudar depois).

<pre>
DBENGINE=MYSQL
DBHOST=localhost
DBNAME=opensips
DBRWUSER=opensips
DBRWPW="opensipsrw"
SIP_DOMAIN=10.254.254.6 ### caso voce esteja usando outro ip altere aqui

DBROOTUSER="root"
INSTALL_EXTRA_TABLES=ask
ALIASES_TYPE="DB"
MI_CONNECTOR=FIFO:/tmp/opensips_fifo
# VERIFY_ACL=1
# ACL_GROUPS="local ld int voicemail free-pstn"
# VERBOSE=1
# STORE_PLAINTEXT_PW=0
# NOHLPRINT=1
PID_FILE=/var/run/opensips/opensips.pid
</pre>

===Criando o banco de dados===
Agora que temos nosso arquivo configurado vamos fazer a criação do banco de dados, execute o comando abaixo.
<pre>
opensipsdbctl create opensips
</pre>

O sistema irá lhe perguntar algumas coisas, responda Y (sim) para todas para que ele instale todas as tabelas, não usaremos todas elas, mas desta forma você fica com praticamente tudo criado para o caso de uma expansão dos recursos.

===Instalando o RTP Proxy===
<pre>
cd /usr/src/
wget -c http://b2bua.org/chrome/site/rtpproxy-1.2.1.tar.gz
tar -xzvf rtpproxy-1.2.1.tar.gz
cd rtpproxy-1.2.1
./configure
make
make install
groupadd rtpproxy
useradd -d /var/run/rtpproxy -s /bin/true -g rtpproxy rtpproxy
mkdir /var/log/rtpproxy
mkdir /var/run/rtpproxy
chown -R rtpproxy.rtpproxy /var/log/rtpproxy
chown -R rtpproxy.rtpproxy /var/run/rtpproxy
</pre>

====Arquivo de inicialização====
'''/etc/init.d/rtpproxy'''
<pre>
#!/bin/bash
#
# Este script e de autoria de Mike Tesliuk
# qualquer falha no mesmo por favor informe
# atraves do email mike (a) tesliuk.com
#
### BEGIN INIT INFO
# Provides: rtpproxy
# Required-Start: $syslog $network $local_fs $time
# Required-Stop: $syslog $network $local_fs
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start the RTPPROXY server
# Description: Start the RTPPROXY server
### END INIT INFO

PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin
USELOG=1
USER=rtpproxy
# Altere o ip abaixo para o ip de seu sistema
IPADDR="10.254.254.6"

. /lib/lsb/init-functions

start(){
echo "Iniciando RTP PROXY "
if [ -z $(pidof rtpproxy) ]; then
if [ "${USELOG}" = "1" ]; then
echo "Iniciando com LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /var/log/rtpproxy/rtpproxy.log &
else
echo "Iniciando sem LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /dev/null
fi

if [ -n $(pidof rtpproxy) ]; then
echo "START OK"
fi
else
echo "Processo ja em execucao"
fi
}

stop(){

if [ -z $(pidof rtpproxy) ]; then
echo "Processo nao encontrado"
else
kill -9 $(pidof rtpproxy)
if [ -n $(pidof rtpproxy) ]; then
echo "STOP OK"
else
echo "Falha em realizar stop do servico"
fi

fi
}

case $1 in
start)
start
;;
stop)
stop
;;
restart)
stop
start

;;
*)
echo "Utilize: stop | start | restart"
;;
esac

</pre>

Vamos dar permissao e colocar na inicialização
chmod +x /etc/init.d/rtpproxy
update-rc.d rtpproxy defaults
/etc/init.d/rtpproxy start

===Criando o arquivo opensips.cfg===
O arquivo opensips.cfg é a onde a coisa toda acontece para o opensips, claro que ele dependerá de informações que estarão no banco de dados, mas é onde criamos todas as nossas rotas e validações.

<pre>
####### Global Parameters #########
debug=3
log_stderror=no
log_facility=LOG_LOCAL0

fork=yes
children=4

/* Descomente as linhas abaixo para ativar o debug */
#debug=7
#fork=no
#log_stderror=yes

/* Comente a linha abaixo para ativar a descoberta automatica de enderecos locais
, isso significa que o sistema ira verificar todos os ips ativos e hosts e entao ativara
o protocolo para todos eles */
auto_aliases=no

/* Defina aqui o ip a ser utilizado */
listen=udp:10.254.254.6:5060 # Altere este IP para o seu ambiente

/* Nao usaremos sip por tcp nem tls neste script */
disable_tcp=yes

disable_tls=yes

####### Secao de modulos ########

#set module path
mpath="/usr//lib64/opensips/modules/"

loadmodule "signaling.so"
loadmodule "sl.so"
loadmodule "tm.so"
modparam("tm", "fr_timer", 5)
modparam("tm", "fr_inv_timer", 30)
modparam("tm", "restart_fr_on_each_reply", 0)
modparam("tm", "onreply_avp_mode", 1)

loadmodule "rr.so"
/* do not append from tag to the RR (no need for this script) */
modparam("rr", "append_fromtag", 0)

loadmodule "maxfwd.so"
loadmodule "sipmsgops.so"
loadmodule "mi_fifo.so"
modparam("mi_fifo", "fifo_name", "/tmp/opensips_fifo")
modparam("mi_fifo", "fifo_mode", 0666)

loadmodule "db_mysql.so"

loadmodule "uri.so"
modparam("uri", "use_uri_table", 0)

loadmodule "usrloc.so"
modparam("usrloc", "nat_bflag", "FLB_NATB")
modparam("usrloc", "db_mode", 2)
modparam("usrloc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "registrar.so"
modparam("registrar", "tcp_persistent_flag", "TCP_PERSISTENT")

/* Descomente a linha abaixo para nao permitir mais de 10 contatos por conta */
#modparam("registrar", "max_contacts", 10)

loadmodule "acc.so"
/* Quais eventos deverao ser registrados ? */
modparam("acc", "early_media", 0)
modparam("acc", "report_cancels", 0)
/* por padrao nos nao ajustamos a direcao em requisicoes sequencias,
se voce deseja usar este recurso tenha certeza de ativar o "appen_fromtag"
para o modulo "rr" */
modparam("acc", "detect_direction", 0)
modparam("acc", "failed_transaction_flag", "FLT_ACCFAILED")
/* Gatilhos para accounting (flags) */
modparam("acc", "log_flag", "FLT_ACC")
modparam("acc", "log_missed_flag", "FLT_ACCMISSED")
modparam("acc", "log_extra",
"src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd")
modparam("acc", "db_flag", "FLT_ACC")
modparam("acc", "db_missed_flag", "FLT_ACCMISSED")
modparam("acc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("acc", "db_extra", "src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd" )

loadmodule "auth.so"
loadmodule "auth_db.so"
modparam("auth_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("auth_db", "calculate_ha1", yes)
modparam("auth_db", "password_column", "password")
modparam("auth_db", "load_credentials", "")

loadmodule "permissions.so"
modparam("permissions", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "alias_db.so"
modparam("alias_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "presence.so"
modparam("presence", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

#loadmodule "presence_xml.so"

loadmodule "dialog.so"
modparam("dialog", "db_mode", 2)
modparam("dialog", "db_url","mysql://opensips:opensipsrw@localhost/opensips")
modparam("dialog", "dlg_match_mode", 1)
#modparam("dialog", "default_timeout", 60)

loadmodule "siptrace.so"
modparam("siptrace", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("siptrace", "trace_flag", 22)
modparam("siptrace", "traced_user_avp", "$avp(s:traceuser)")

loadmodule "nathelper.so"
modparam("nathelper", "natping_interval", 30)
modparam("nathelper", "ping_nated_only", 1)
modparam("nathelper", "sipping_bflag", "FLB_NATSIPPING")
modparam("nathelper", "sipping_from", "sip:pinger@10.254.254.6") # Altere o ip para o ip do servidor
modparam("nathelper|registrar", "received_avp", "$avp(RECEIVED)")

loadmodule "rtpproxy.so"
modparam("rtpproxy", "rtpproxy_sock", "udp:127.0.0.1:7722")

####### Logica de roteamento ########

route {

if (!mf_process_maxfwd_header("3")) {
send_reply("483","looping");
exit;
}

xlog("REQUISICAO RECEBIDA, ENVIANDO PARA REQINIT");
# Checagem inicial por requisicao
route(REQINIT);

xlog("ENVIANDO PARA NAT");
# Deteccao de nat
route(NAT);

xlog("ENVIANDO PARA WITHINDLG");
# Gerenciando requisicaoes com dialog
route(WITHINDLG);

# Manipulando requisicoes iniciais (nao consta To tag)

# Processando CANCEL

if(is_method("CANCEL")){
xlog("METHOD CANCEL");
if(t_check_trans()){
t_relay();
}
exit;
}

t_check_trans();

# Enviando para autenticacao
xlog("ENVIANDO PARA AUTENTICACAO");
route(AUTH);

# gravando rota para formacao dos dialogs (caso sejam roteados)
# removemos qualquer cabecalho de rota pre carregado
remove_hf("Route");
if(is_method("INVITE|SUBSCRIBE")){
xlog("METHOD INVITE OU SIBSCRIBE");
record_route();
}

# Contabilizando (acc) INVITES
if(is_method("INVITE")){
xlog("METHOD INVITE, FAZENDOA ACC");
setflag(FLT_ACC);
}

# Enviando chamada para destinos externos
xlog("ENVIANDO PARA SIPOUT");
route(SIPOUT);

# Requisicoes para dominio local

# Roteando requisicoes de PRESENCE
xlog("ENVIANDO PARA PRESENCE");

route(PRESENCE);

# Gerenciando pedidos de registro
xlog("ENVIANDO PARA REGISTRAR");
route(REGISTRAR);

if($ru==""){
xlog("ru --> vazio");
# Requisicao sem usuario na RURI
sl_send_reply("484", "Address Incomplete");
}

# Enviando requisicao para PSTN
xlog("ENVIANDO PARA PSTN");
route(PSTN);

# Salvando informacao de quem originou a chamad
$avp(callee)=$rU;
xlog("ENVIANDO PARA DISPATCH PSTN");
route(FSDISPATCH);

# Servico de localizacao de usuario
route(LOCATION);

# Efetuando o relay (encaminhamento)
route(RELAY);

}

route[RELAY] {
if(check_route_param("nat=yes")){
setbflag(FLB_NATB);
}

if(isflagset(FLT_NATS) || isbflagset(FLB_NATB)){
#route(RTPPROXY);
}

# if(is_method("INVITE")){
# t_on_reply("REPLY_ONE");
# t_on_failure("FAIL_ONE");
# }

xlog("AQUI TENTAMOS ENVIAR A CHAMADA $fU $tU");
if(!t_relay()){
xlog("FALHA EM ENVIAR A CHAMADA, NAO FOI POSSIVEL FAZER O RELAY");
sl_reply_error();
}
xlog("CHAMADA FOI ENVIADA AQUI, QUAL O ERRO ENTAO");

exit;
}

route[REQINIT] {
if(!mf_process_maxfwd_header("10")){
sl_send_reply("483", "Too Many Hops");
exit;
}

}

route[WITHINDLG] {
if(has_totag()){
if(loose_route()){
if(is_method("BYE")){
setflag(FLT_ACC);
setflag(FLT_ACCFAILED);
}
route(RELAY);
}else{
if(is_method("SUBSCRIBE") && uri==myself) {
# requisicao de subscribe pre-estabelecida
route(PRESENCE);
exit;
}

if(is_method("ACK")){
if(t_check_trans()){
t_relay();
exit;
}
}else{
# ACK para transacao nao encontrada, ignoramos...
exit;

}

sl_send_reply("404", "Not Here");

}
exit;
}
}

route[REGISTRAR] {

if(is_method("REGISTER")){
if(isflagset(FLT_NATS)){
setbflag(FLB_NATB);
}

if(!save("location")){
sl_reply_error();
}

exit;
}

}

route[LOCATION] {

alias_db_lookup("dbaliases");
if(!lookup("location")){
switch($rc) {
case -1:
case -3:
t_newtran();
t_reply("404","Not Found");
exit;
case -2:
sl_send_reply("405", "Method Not Allowed");
exit;
}
}

if(is_method("INVITE")){
setflag(FLT_ACCMISSED);
}

}

route[PRESENCE] {
if(!is_method("PUBLISH|SUBSCRIBE")){
return;
}

if(!t_newtran()){
sl_reply_error();
exit;
}

if(is_method("PUBLISH")){
handle_publish();
}else if(is_method("SUBSCRIBE")){
handle_subscribe();
}
exit;

}

route[AUTH]{
xlog("PEDIDO DE AUTENTICACAO");
if(is_method("REGISTER")){
# atentica pedidos de registro
if(!www_authorize("", "subscriber")){
www_challenge("", "0");
exit;
}

if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if(route(FSINBOUND)){
return;
}

if(check_source_address("0")){
return;
}

if(from_uri==myself){
if(!proxy_authorize("", "subscriber")){
proxy_challenge("","0");
exit;
}

if(is_method("PUBLISH")){
if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if($au!=$fU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}
}

# Validamos (autenticamos) o usuario
consume_credentials();
}else{

# usuario nao e local, vamos negar
if(!uri==myself){
sl_send_reply("403", "Not relaying");
exit;
}
}
}

return;
}

route[NAT] {
force_rport();
if(nat_uac_test("19")){
if(method=="REGISTER"){
fix_nated_register();
}else{
fix_nated_contact();
}
setflag(FLT_NATS);
}

return;
}

route[RTPPROXY] {
if(is_method("BYE")){
unforce_rtp_proxy();
}else if(is_method("INVITE")){
engage_rtp_proxy();
}

if(!has_totag()){

if(!check_route_param("nat=yes")){
add_rr_param(";nat=yes");
xlog("NAT yes NAO ENCONTRADO");
}
}

return;
}

route[SIPOUT]{
if(!uri==myself){
append_hf("P-hint: outbound\r\n");
route(RELAY);
}
}

route[PSTN]{
# neste caso apenas para exemplificar um uso simples
# vamos fazer o redirecionamento par ao asterisk
# realizar a dicagem da chamada

if(!($rU=~"^(\+|00)[1-9][0-9]{3,20}$"))
return;

## a regra acima aceita para discagem externa qualquer numero
# comecado com 00 ou +
#

if(from_uri!=myself){
sl_send_reply("403", "Not Allowed");
exit;
}

$ru = "sip:" + $rU + "@" + "10.254.254.6:5090";
xlog("NOVO DESTINO: $ru");
route(RELAY);
exit;

}

route[XMLRPC]{
# nao vamos implementar esta funcionalidade
return;
}

route[FSINBOUND] {
# verificar para validar o ip do asterisk:porta
# se bater , responder com return 1;
if($si=="10.254.254.6" && $sp=="5090"){
return(1);
}else{
return(-1);
}
}

route[FSDISPATCH] {

if(!is_method("INVITE")){
return;
}

if(route(FSINBOUND)){
return;
}

xlog("CAIMOS NO SWITCH, VAMOS LOCALIZAR O PERFIL DA CHAMADA $rU");

if($rU =~ "^41$"){
xlog("SWITCH expressa comeca e termina em 41");
#regra de menu de voicemail, apenas
# usuarios autenticados
if($au==""){
sl_send_reply("403", "Not Allowed");
exit;
}

$rU = "vma-" + $au;
}else if($rU =~ "^441[0-9][0-9]$"){
xlog("SWTICH OPCA 441XX ");
# numero discado comeca com 441 seguido de dois digitos
# chamada direta para inbox do voicemail
strip(2);
route(FSVBOX);
}else if($rU =~ "^433[01][0-9][0-9]$"){
xlog("SWITCH OPCAO 433[01]XX");
# numero comecado em 443, seguido de 0 ou 1, mais dois digitos
# sistema de conferencia
strip(2);
}else if($rU =~ "^45[0-9]+$"){
xlog("SWTICH OPCAO 45X.");
#numero comecado com 45, seguindo de numeros;
strip(2);
}else{
xlog("OPCAO DEFAULT DO SWITCH");
# usuario offline, enviando para voicemail
if(!registered("location")){
route(FSVBOX);
exit;
}

# usuario online, fazendo bridging
xlog("USUARIO ESTA ONLINE VAMOS FAZER BRIDGE");
prefix("kb-");
if(is_method("INVITE")){
t_on_failure("FAIL_FSVBOX");
}
}
route(FSRELAY);
exit;
}

route[FSVBOX]{
xlog("ENVIANDO PARA FSVBOX");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($rU =~ "^441[0-9][0-9]"){
strip(2);
}
prefix("vm-");
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;
}

route[FSRELAY] {
xlog("ENVIANDO PARA FSRELAY");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;

}

branch_route[BRANCH_ONE]{
xlog("new branch at $ru");
}

onreply_route[REPLY_ONE]{
xlog("Incoming reply");
if((isflagset(FLT_NATS) || isbflagset(FLB_NATB) && status =~ "(183)|(2[0-9][0-9])")){
#rtpproxy_offer();

}
if(isbflagset(FLB_NATB)){
fix_nated_contact();
}

}

failure_route[FAIL_ONE]{
xlog("FAILURE ROUTE FAIL_ONE");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

}

failure_route[FAIL_FSVBOX]{
xlog("FAILURE ROUTE FAIL_FSVBOX");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

if(t_check_status("486|408|480")){
$rU = $avp(callee);
$var(newbranch) = 1;
route(FSVBOX);
}
}

</pre>

==Testes com Opensips (registro)==

Antes de podermos testar precisamos iniciar o serviço, no momento estamos com ele operando em modo debug, então a inicialização deve ser realizada com o comando abaixo
/etc/init.d/opensips debug

Abra uma nova sessão no servidor e então vamos criar os usuários
opensipsctl add 101 101
opensipsctl add 102 102
opensipsctl add 103 103

usuario 101 com senha 101 e assim por diante

Faça a onexão com seu softphone, aqui para testes utilizei o jitsi e o zoiper, neste momento vamos apenas fazer o registro do usuário para testar a autenticação, se você tentar realizar uma discagem não funcionará pois neste caso o processo depende do Asterisk que ainda não está configurado, vamos dar inicio nesta configuração agora.

==Asterisk==
Não vamos dar muitos detalhes da instalação do asterisk aqui, a ideia é simplesmente ter o mesmo funcionando da forma que necessitamos.
apt-get install asterisk

Após a instalação , abra o arquivo /etc/asterisk/sip.conf, localize a linha '''udpbindaddr=0.0.0.0''' e altere para '''udpbindaddr=0.0.0.0:5090''' , depois ao fim do arquivo adicione.
<pre>
[opensips]
type=peer
host=10.254.254.6
port=5060
qualify=yes
context=opensips
insecure=port,invite
canreinvite=no
</pre>

Agora abra o arquivo '''/etc/asterisk/extensions.conf''' , crie no fim do arquivo a seguinte entrada.
<pre>
[opensips]

exten => _kb-1XX,1,NoOp(CHAMADA INTERNA - FAZER BRIDGE - ${CALLERID(num)} ${EXTEN:3})
same => n,Dial(SIP/opensips/${EXTEN:3})
same => n,Goto(opensips,vm-${EXTEN:3},1)
same => n,Hangup()

exten => _vm-1XX,1,NoOp(CHAMADA PARA VOICEMAIL)
same => n,Voicemail(${EXTEN:3}@default)
same => n,Hangup()

exten => _vma-1XX,1,NoOp(CHAMADA PARA VOICEMAIL - ADMINISTRATIVO)
same => n,VoicemailMain(${EXTEN:4}@default)
same => n,Hangup()

exten => _3[01]XX,1,NoOp(CHAMADA PARA CONFERENCIA)
same => n,Answer()
same => n,ConfBridge(${EXTEN},cM1)
same => n,Hangup()

exten => _00.,1,NoOp(CHAMADA PARA PSTN)
same => n,Wait(2)
same => n,Answer()
same => n,Wait(1)
same => n,PlayBack(tt-monkeys)
same => n,Hangup()

exten => h,1,Hangup()

</pre>

Finalmente precisamos criar as entradas do voicemail, para isso altere o arquivo '''/etc/asterisk/voicemail.conf''' localize o contexto '''[default]''' e então adicione as entradas para seu voicemail, segue dois exemplos abaixo.
<pre>
101 => 123123,Mike Tesliuk
102 => 123123,Mike Tesliuk 2
</pre>

Feito isso, faça um restart no asterisk
/etc/init.d/asterisk restart

Agora você ja poderá fazer os testes, basicamente criamos as seguintes situações para serem testadas.

*1 Autenticação de usuários
*2 Chamada entre usuários
*3 Encaminhamento para caixa postal
*4 Acesso a caixa postal
*5 Acesso a conferência

OpenSIPs e Asterisk

2021-04-15T22:54:29Z

Admin:

{| class="wikitable"
|-
|Precisando de recursos de númeração para fazer seus testes ? contrate conosco em [www.brdvoz.com.br]
|-
|}

<table>
<tr><td style="background-color: red;"><b><font color=white> Falta realizar os ajustes / testes para o NAT no mais esta tudo funcionado adequadamente a principio </font></b></td></tr>
</table>

Este tutorial é baseado em um tutorial similar porém utilizando Kamailio e Freeswtich, se quiser verificar o tutorial original acesse http://kb.asipto.com/freeswitch:kamailio-3.1.x-freeswitch-1.0.6d-sbc.

Para esta implementação utilizamos Debian 7.0 amd64 , OpenSIPS 1.9 e Asterisk 1.8.23

==Funcionalidades==
Este tutorial tem por objetivo atingir as seguintes funcionalidades.
*Autenticação de usuário
*Registro de usuário
*Localização de usuário (encaminhamento de chamadas)
*Roteamento de chamadas

Através do Asterisk estenderemos estas funcionalidades agregando.
*Correio de voz (Voicemail)
*Conferencia
*SBC ( Pode ser utilizado para transcoding, esconder topologia, play de mensagens e tarifação )
*Outros serviços de media (Anuncios, Ura's e coisas do tipo)

==Definições==
Para um melhor entendimento da solução vamos expor aqui algumas definições de nosso sistema.
*Usuários locais terão ramais com 3 digitos (ex: 101, 102, 103)
*Identidade do correio de voz será o mesmo do ramal
*Serviços de media (acesso a voicemail e outros) receberão rotas de 4 digitos
*Opensips e Asterisk utilizarão o mesmo servidor (Neste caso IP: 10.254.254.6)
*Os serviços rodarão nas portas 5060 (opensips) , 5090 (Asterisk)

==Funcionamento==
A autenticação do usuário será realizada pelo OpenSIPs, quando uma chamada é autenticada então ela serguirá:
*Se o usuário de destino não está online a chamada será enviada para o Asterisk para função de correio de voz
*Se o usuário está online a chamada será encaminhada para o Asterisk, dest forma é possivel acionar funcionalidades como anuncios, definição de tempo de chamada, forçar codecs e outras funcionalidades.
*Asterisk envia a chamada novamente para o OpenSIPs que verificará no location e entregará a chamada para o usuário.
*Se a chamada não for atendida o Opensips irá re-encaminhar para o Asterisk direcionando para função de voicemail

==OpenSIPs==
Vamos iniciar o processo de instalação com o OpenSIPs, siga os procedimentos abaixo para evitar qualquer dificuldade.

===Dependencias===
Execute o comando abaixo para instalar todas as dependencias necessárias
<pre>
apt-get install gcc make libncurses5-dev libnewt-dev libxml2-dev unixodbc \
unixodbc-dev libmysqlclient15-dev libxmlrpc-c3-dev libexpat1-dev zlib1g-dev \
m4 bison flex libpcre3-dev mysql-server vim apache2-mpm-prefork libapache2-mod-php5 \
php5-mysql php5-xmlrpc php-pear ngrep g++ libjpeg62-dev libssl-dev
</pre>

Durante a instalação o sistema irá lhe perguntar a senha de root para o servidor MySQL é importante que você se lembre da mesma posteriormente pois utilizaremos a mesma.

===Compilando o OpenSIPs===
Para manter um padrão onde os dados estao vamos utilizar o diretório /usr/src/ para o download de código fonte.

cd /usr/src/
wget -c http://opensips.org/pub/opensips/1.9.1/src/opensips-1.9.1_src.tar.gz
tar -xzvf opensips-1.9.1_src.tar.gz
cd opensips-1.9.1-tls/
make menuconfig

Neste ponto o sistema irá abrir uma tela com algumas opções para selecionar, Acesse a primeira opção do menu, no submenu acesse a segunda opção ( Configure excluded modules ), selecione os módulos db_mysql , dialplan , mi_xmlrpc , presence e presence_xml

Agora volte ao submenu, e selecione a opção Save Changes, volte para o menu principal e selecione '''Compile and Install OpenSips''' , deixe que o sistema execute suas funções.

Ao finalizar a compilação você retornará ao menu, va na opção '''Exit and Save all changes'''

===Preparando a Configuração===

Antes de darmos inicio ao arquivo de configuração, vamos ajustar algumas questões, o opensips instala os arquivos (se voce nao alterar o parametro) em /usr, consequentemente as configurações ficam em /usr/etc , eu por padrão faço um link para o diretório /etc, assim acesso as configurações em /etc/opensips

ln -s /usr/etc/opensips /etc/

No caso do debian o script de inicialização utiliza um arquivo extra de configuração
cp packaging/debian/opensips.default /etc/default/opensips

Para o script de inicialização execute o comando abaixo
cp packaging/debian/opensips.init /etc/init.d/opensips
chmod +x /etc/init.d/opensips
update-rc.d opensips defaults

Edite o arquivo /etc/default/opensips , a altere o parametro '''RUN_OPENSIPS''' para yes

Você pode notar que no arquivo é mensionado o usuário de execução do opensips como opensips, então vamos ter de criar este usuário ( e grupo )

groupadd opensips
mkdir /var/run/opensips
useradd -d /var/run/opensips/ -s /bin/false -g opensips opensips
chown -R opensips.opensips /var/run/opensips

===Configurando o opensipsctl===
O opensipsctl (e opensipsdbctl) utilizam o arquivo de configuração /etc/opensips/opensipsctlrc, abaixo segue o conteúdo do arquivo. (Sugiro que você faça um backup dos arquivos originais para ter uma copia, existem parametros que você pode estudar depois).

<pre>
DBENGINE=MYSQL
DBHOST=localhost
DBNAME=opensips
DBRWUSER=opensips
DBRWPW="opensipsrw"
SIP_DOMAIN=10.254.254.6 ### caso voce esteja usando outro ip altere aqui

DBROOTUSER="root"
INSTALL_EXTRA_TABLES=ask
ALIASES_TYPE="DB"
MI_CONNECTOR=FIFO:/tmp/opensips_fifo
# VERIFY_ACL=1
# ACL_GROUPS="local ld int voicemail free-pstn"
# VERBOSE=1
# STORE_PLAINTEXT_PW=0
# NOHLPRINT=1
PID_FILE=/var/run/opensips/opensips.pid
</pre>

===Criando o banco de dados===
Agora que temos nosso arquivo configurado vamos fazer a criação do banco de dados, execute o comando abaixo.
<pre>
opensipsdbctl create opensips
</pre>

O sistema irá lhe perguntar algumas coisas, responda Y (sim) para todas para que ele instale todas as tabelas, não usaremos todas elas, mas desta forma você fica com praticamente tudo criado para o caso de uma expansão dos recursos.

===Instalando o RTP Proxy===
<pre>
cd /usr/src/
wget -c http://b2bua.org/chrome/site/rtpproxy-1.2.1.tar.gz
tar -xzvf rtpproxy-1.2.1.tar.gz
cd rtpproxy-1.2.1
./configure
make
make install
groupadd rtpproxy
useradd -d /var/run/rtpproxy -s /bin/true -g rtpproxy rtpproxy
mkdir /var/log/rtpproxy
mkdir /var/run/rtpproxy
chown -R rtpproxy.rtpproxy /var/log/rtpproxy
chown -R rtpproxy.rtpproxy /var/run/rtpproxy
</pre>

====Arquivo de inicialização====
'''/etc/init.d/rtpproxy'''
<pre>
#!/bin/bash
#
# Este script e de autoria de Mike Tesliuk
# qualquer falha no mesmo por favor informe
# atraves do email mike (a) tesliuk.com
#
### BEGIN INIT INFO
# Provides: rtpproxy
# Required-Start: $syslog $network $local_fs $time
# Required-Stop: $syslog $network $local_fs
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start the RTPPROXY server
# Description: Start the RTPPROXY server
### END INIT INFO

PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin
USELOG=1
USER=rtpproxy
# Altere o ip abaixo para o ip de seu sistema
IPADDR="10.254.254.6"

. /lib/lsb/init-functions

start(){
echo "Iniciando RTP PROXY "
if [ -z $(pidof rtpproxy) ]; then
if [ "${USELOG}" = "1" ]; then
echo "Iniciando com LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /var/log/rtpproxy/rtpproxy.log &
else
echo "Iniciando sem LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /dev/null
fi

if [ -n $(pidof rtpproxy) ]; then
echo "START OK"
fi
else
echo "Processo ja em execucao"
fi
}

stop(){

if [ -z $(pidof rtpproxy) ]; then
echo "Processo nao encontrado"
else
kill -9 $(pidof rtpproxy)
if [ -n $(pidof rtpproxy) ]; then
echo "STOP OK"
else
echo "Falha em realizar stop do servico"
fi

fi
}

case $1 in
start)
start
;;
stop)
stop
;;
restart)
stop
start

;;
*)
echo "Utilize: stop | start | restart"
;;
esac

</pre>

Vamos dar permissao e colocar na inicialização
chmod +x /etc/init.d/rtpproxy
update-rc.d rtpproxy defaults
/etc/init.d/rtpproxy start

===Criando o arquivo opensips.cfg===
O arquivo opensips.cfg é a onde a coisa toda acontece para o opensips, claro que ele dependerá de informações que estarão no banco de dados, mas é onde criamos todas as nossas rotas e validações.

<pre>
####### Global Parameters #########
debug=3
log_stderror=no
log_facility=LOG_LOCAL0

fork=yes
children=4

/* Descomente as linhas abaixo para ativar o debug */
#debug=7
#fork=no
#log_stderror=yes

/* Comente a linha abaixo para ativar a descoberta automatica de enderecos locais
, isso significa que o sistema ira verificar todos os ips ativos e hosts e entao ativara
o protocolo para todos eles */
auto_aliases=no

/* Defina aqui o ip a ser utilizado */
listen=udp:10.254.254.6:5060 # Altere este IP para o seu ambiente

/* Nao usaremos sip por tcp nem tls neste script */
disable_tcp=yes

disable_tls=yes

####### Secao de modulos ########

#set module path
mpath="/usr//lib64/opensips/modules/"

loadmodule "signaling.so"
loadmodule "sl.so"
loadmodule "tm.so"
modparam("tm", "fr_timer", 5)
modparam("tm", "fr_inv_timer", 30)
modparam("tm", "restart_fr_on_each_reply", 0)
modparam("tm", "onreply_avp_mode", 1)

loadmodule "rr.so"
/* do not append from tag to the RR (no need for this script) */
modparam("rr", "append_fromtag", 0)

loadmodule "maxfwd.so"
loadmodule "sipmsgops.so"
loadmodule "mi_fifo.so"
modparam("mi_fifo", "fifo_name", "/tmp/opensips_fifo")
modparam("mi_fifo", "fifo_mode", 0666)

loadmodule "db_mysql.so"

loadmodule "uri.so"
modparam("uri", "use_uri_table", 0)

loadmodule "usrloc.so"
modparam("usrloc", "nat_bflag", "FLB_NATB")
modparam("usrloc", "db_mode", 2)
modparam("usrloc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "registrar.so"
modparam("registrar", "tcp_persistent_flag", "TCP_PERSISTENT")

/* Descomente a linha abaixo para nao permitir mais de 10 contatos por conta */
#modparam("registrar", "max_contacts", 10)

loadmodule "acc.so"
/* Quais eventos deverao ser registrados ? */
modparam("acc", "early_media", 0)
modparam("acc", "report_cancels", 0)
/* por padrao nos nao ajustamos a direcao em requisicoes sequencias,
se voce deseja usar este recurso tenha certeza de ativar o "appen_fromtag"
para o modulo "rr" */
modparam("acc", "detect_direction", 0)
modparam("acc", "failed_transaction_flag", "FLT_ACCFAILED")
/* Gatilhos para accounting (flags) */
modparam("acc", "log_flag", "FLT_ACC")
modparam("acc", "log_missed_flag", "FLT_ACCMISSED")
modparam("acc", "log_extra",
"src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd")
modparam("acc", "db_flag", "FLT_ACC")
modparam("acc", "db_missed_flag", "FLT_ACCMISSED")
modparam("acc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("acc", "db_extra", "src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd" )

loadmodule "auth.so"
loadmodule "auth_db.so"
modparam("auth_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("auth_db", "calculate_ha1", yes)
modparam("auth_db", "password_column", "password")
modparam("auth_db", "load_credentials", "")

loadmodule "permissions.so"
modparam("permissions", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "alias_db.so"
modparam("alias_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "presence.so"
modparam("presence", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

#loadmodule "presence_xml.so"

loadmodule "dialog.so"
modparam("dialog", "db_mode", 2)
modparam("dialog", "db_url","mysql://opensips:opensipsrw@localhost/opensips")
modparam("dialog", "dlg_match_mode", 1)
#modparam("dialog", "default_timeout", 60)

loadmodule "siptrace.so"
modparam("siptrace", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("siptrace", "trace_flag", 22)
modparam("siptrace", "traced_user_avp", "$avp(s:traceuser)")

loadmodule "nathelper.so"
modparam("nathelper", "natping_interval", 30)
modparam("nathelper", "ping_nated_only", 1)
modparam("nathelper", "sipping_bflag", "FLB_NATSIPPING")
modparam("nathelper", "sipping_from", "sip:pinger@10.254.254.6") # Altere o ip para o ip do servidor
modparam("nathelper|registrar", "received_avp", "$avp(RECEIVED)")

loadmodule "rtpproxy.so"
modparam("rtpproxy", "rtpproxy_sock", "udp:127.0.0.1:7722")

####### Logica de roteamento ########

route {

if (!mf_process_maxfwd_header("3")) {
send_reply("483","looping");
exit;
}

xlog("REQUISICAO RECEBIDA, ENVIANDO PARA REQINIT");
# Checagem inicial por requisicao
route(REQINIT);

xlog("ENVIANDO PARA NAT");
# Deteccao de nat
route(NAT);

xlog("ENVIANDO PARA WITHINDLG");
# Gerenciando requisicaoes com dialog
route(WITHINDLG);

# Manipulando requisicoes iniciais (nao consta To tag)

# Processando CANCEL

if(is_method("CANCEL")){
xlog("METHOD CANCEL");
if(t_check_trans()){
t_relay();
}
exit;
}

t_check_trans();

# Enviando para autenticacao
xlog("ENVIANDO PARA AUTENTICACAO");
route(AUTH);

# gravando rota para formacao dos dialogs (caso sejam roteados)
# removemos qualquer cabecalho de rota pre carregado
remove_hf("Route");
if(is_method("INVITE|SUBSCRIBE")){
xlog("METHOD INVITE OU SIBSCRIBE");
record_route();
}

# Contabilizando (acc) INVITES
if(is_method("INVITE")){
xlog("METHOD INVITE, FAZENDOA ACC");
setflag(FLT_ACC);
}

# Enviando chamada para destinos externos
xlog("ENVIANDO PARA SIPOUT");
route(SIPOUT);

# Requisicoes para dominio local

# Roteando requisicoes de PRESENCE
xlog("ENVIANDO PARA PRESENCE");

route(PRESENCE);

# Gerenciando pedidos de registro
xlog("ENVIANDO PARA REGISTRAR");
route(REGISTRAR);

if($ru==""){
xlog("ru --> vazio");
# Requisicao sem usuario na RURI
sl_send_reply("484", "Address Incomplete");
}

# Enviando requisicao para PSTN
xlog("ENVIANDO PARA PSTN");
route(PSTN);

# Salvando informacao de quem originou a chamad
$avp(callee)=$rU;
xlog("ENVIANDO PARA DISPATCH PSTN");
route(FSDISPATCH);

# Servico de localizacao de usuario
route(LOCATION);

# Efetuando o relay (encaminhamento)
route(RELAY);

}

route[RELAY] {
if(check_route_param("nat=yes")){
setbflag(FLB_NATB);
}

if(isflagset(FLT_NATS) || isbflagset(FLB_NATB)){
#route(RTPPROXY);
}

# if(is_method("INVITE")){
# t_on_reply("REPLY_ONE");
# t_on_failure("FAIL_ONE");
# }

xlog("AQUI TENTAMOS ENVIAR A CHAMADA $fU $tU");
if(!t_relay()){
xlog("FALHA EM ENVIAR A CHAMADA, NAO FOI POSSIVEL FAZER O RELAY");
sl_reply_error();
}
xlog("CHAMADA FOI ENVIADA AQUI, QUAL O ERRO ENTAO");

exit;
}

route[REQINIT] {
if(!mf_process_maxfwd_header("10")){
sl_send_reply("483", "Too Many Hops");
exit;
}

}

route[WITHINDLG] {
if(has_totag()){
if(loose_route()){
if(is_method("BYE")){
setflag(FLT_ACC);
setflag(FLT_ACCFAILED);
}
route(RELAY);
}else{
if(is_method("SUBSCRIBE") && uri==myself) {
# requisicao de subscribe pre-estabelecida
route(PRESENCE);
exit;
}

if(is_method("ACK")){
if(t_check_trans()){
t_relay();
exit;
}
}else{
# ACK para transacao nao encontrada, ignoramos...
exit;

}

sl_send_reply("404", "Not Here");

}
exit;
}
}

route[REGISTRAR] {

if(is_method("REGISTER")){
if(isflagset(FLT_NATS)){
setbflag(FLB_NATB);
}

if(!save("location")){
sl_reply_error();
}

exit;
}

}

route[LOCATION] {

alias_db_lookup("dbaliases");
if(!lookup("location")){
switch($rc) {
case -1:
case -3:
t_newtran();
t_reply("404","Not Found");
exit;
case -2:
sl_send_reply("405", "Method Not Allowed");
exit;
}
}

if(is_method("INVITE")){
setflag(FLT_ACCMISSED);
}

}

route[PRESENCE] {
if(!is_method("PUBLISH|SUBSCRIBE")){
return;
}

if(!t_newtran()){
sl_reply_error();
exit;
}

if(is_method("PUBLISH")){
handle_publish();
}else if(is_method("SUBSCRIBE")){
handle_subscribe();
}
exit;

}

route[AUTH]{
xlog("PEDIDO DE AUTENTICACAO");
if(is_method("REGISTER")){
# atentica pedidos de registro
if(!www_authorize("", "subscriber")){
www_challenge("", "0");
exit;
}

if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if(route(FSINBOUND)){
return;
}

if(check_source_address("0")){
return;
}

if(from_uri==myself){
if(!proxy_authorize("", "subscriber")){
proxy_challenge("","0");
exit;
}

if(is_method("PUBLISH")){
if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if($au!=$fU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}
}

# Validamos (autenticamos) o usuario
consume_credentials();
}else{

# usuario nao e local, vamos negar
if(!uri==myself){
sl_send_reply("403", "Not relaying");
exit;
}
}
}

return;
}

route[NAT] {
force_rport();
if(nat_uac_test("19")){
if(method=="REGISTER"){
fix_nated_register();
}else{
fix_nated_contact();
}
setflag(FLT_NATS);
}

return;
}

route[RTPPROXY] {
if(is_method("BYE")){
unforce_rtp_proxy();
}else if(is_method("INVITE")){
engage_rtp_proxy();
}

if(!has_totag()){

if(!check_route_param("nat=yes")){
add_rr_param(";nat=yes");
xlog("NAT yes NAO ENCONTRADO");
}
}

return;
}

route[SIPOUT]{
if(!uri==myself){
append_hf("P-hint: outbound\r\n");
route(RELAY);
}
}

route[PSTN]{
# neste caso apenas para exemplificar um uso simples
# vamos fazer o redirecionamento par ao asterisk
# realizar a dicagem da chamada

if(!($rU=~"^(\+|00)[1-9][0-9]{3,20}$"))
return;

## a regra acima aceita para discagem externa qualquer numero
# comecado com 00 ou +
#

if(from_uri!=myself){
sl_send_reply("403", "Not Allowed");
exit;
}

$ru = "sip:" + $rU + "@" + "10.254.254.6:5090";
xlog("NOVO DESTINO: $ru");
route(RELAY);
exit;

}

route[XMLRPC]{
# nao vamos implementar esta funcionalidade
return;
}

route[FSINBOUND] {
# verificar para validar o ip do asterisk:porta
# se bater , responder com return 1;
if($si=="10.254.254.6" && $sp=="5090"){
return(1);
}else{
return(-1);
}
}

route[FSDISPATCH] {

if(!is_method("INVITE")){
return;
}

if(route(FSINBOUND)){
return;
}

xlog("CAIMOS NO SWITCH, VAMOS LOCALIZAR O PERFIL DA CHAMADA $rU");

if($rU =~ "^41$"){
xlog("SWITCH expressa comeca e termina em 41");
#regra de menu de voicemail, apenas
# usuarios autenticados
if($au==""){
sl_send_reply("403", "Not Allowed");
exit;
}

$rU = "vma-" + $au;
}else if($rU =~ "^441[0-9][0-9]$"){
xlog("SWTICH OPCA 441XX ");
# numero discado comeca com 441 seguido de dois digitos
# chamada direta para inbox do voicemail
strip(2);
route(FSVBOX);
}else if($rU =~ "^433[01][0-9][0-9]$"){
xlog("SWITCH OPCAO 433[01]XX");
# numero comecado em 443, seguido de 0 ou 1, mais dois digitos
# sistema de conferencia
strip(2);
}else if($rU =~ "^45[0-9]+$"){
xlog("SWTICH OPCAO 45X.");
#numero comecado com 45, seguindo de numeros;
strip(2);
}else{
xlog("OPCAO DEFAULT DO SWITCH");
# usuario offline, enviando para voicemail
if(!registered("location")){
route(FSVBOX);
exit;
}

# usuario online, fazendo bridging
xlog("USUARIO ESTA ONLINE VAMOS FAZER BRIDGE");
prefix("kb-");
if(is_method("INVITE")){
t_on_failure("FAIL_FSVBOX");
}
}
route(FSRELAY);
exit;
}

route[FSVBOX]{
xlog("ENVIANDO PARA FSVBOX");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($rU =~ "^441[0-9][0-9]"){
strip(2);
}
prefix("vm-");
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;
}

route[FSRELAY] {
xlog("ENVIANDO PARA FSRELAY");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;

}

branch_route[BRANCH_ONE]{
xlog("new branch at $ru");
}

onreply_route[REPLY_ONE]{
xlog("Incoming reply");
if((isflagset(FLT_NATS) || isbflagset(FLB_NATB) && status =~ "(183)|(2[0-9][0-9])")){
#rtpproxy_offer();

}
if(isbflagset(FLB_NATB)){
fix_nated_contact();
}

}

failure_route[FAIL_ONE]{
xlog("FAILURE ROUTE FAIL_ONE");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

}

failure_route[FAIL_FSVBOX]{
xlog("FAILURE ROUTE FAIL_FSVBOX");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

if(t_check_status("486|408|480")){
$rU = $avp(callee);
$var(newbranch) = 1;
route(FSVBOX);
}
}

</pre>

==Testes com Opensips (registro)==

Antes de podermos testar precisamos iniciar o serviço, no momento estamos com ele operando em modo debug, então a inicialização deve ser realizada com o comando abaixo
/etc/init.d/opensips debug

Abra uma nova sessão no servidor e então vamos criar os usuários
opensipsctl add 101 101
opensipsctl add 102 102
opensipsctl add 103 103

usuario 101 com senha 101 e assim por diante

Faça a onexão com seu softphone, aqui para testes utilizei o jitsi e o zoiper, neste momento vamos apenas fazer o registro do usuário para testar a autenticação, se você tentar realizar uma discagem não funcionará pois neste caso o processo depende do Asterisk que ainda não está configurado, vamos dar inicio nesta configuração agora.

==Asterisk==
Não vamos dar muitos detalhes da instalação do asterisk aqui, a ideia é simplesmente ter o mesmo funcionando da forma que necessitamos.
apt-get install asterisk

Após a instalação , abra o arquivo /etc/asterisk/sip.conf, localize a linha '''udpbindaddr=0.0.0.0''' e altere para '''udpbindaddr=0.0.0.0:5090''' , depois ao fim do arquivo adicione.
<pre>
[opensips]
type=peer
host=10.254.254.6
port=5060
qualify=yes
context=opensips
insecure=port,invite
canreinvite=no
</pre>

Agora abra o arquivo '''/etc/asterisk/extensions.conf''' , crie no fim do arquivo a seguinte entrada.
<pre>
[opensips]

exten => _kb-1XX,1,NoOp(CHAMADA INTERNA - FAZER BRIDGE - ${CALLERID(num)} ${EXTEN:3})
same => n,Dial(SIP/opensips/${EXTEN:3})
same => n,Goto(opensips,vm-${EXTEN:3},1)
same => n,Hangup()

exten => _vm-1XX,1,NoOp(CHAMADA PARA VOICEMAIL)
same => n,Voicemail(${EXTEN:3}@default)
same => n,Hangup()

exten => _vma-1XX,1,NoOp(CHAMADA PARA VOICEMAIL - ADMINISTRATIVO)
same => n,VoicemailMain(${EXTEN:4}@default)
same => n,Hangup()

exten => _3[01]XX,1,NoOp(CHAMADA PARA CONFERENCIA)
same => n,Answer()
same => n,ConfBridge(${EXTEN},cM1)
same => n,Hangup()

exten => _00.,1,NoOp(CHAMADA PARA PSTN)
same => n,Wait(2)
same => n,Answer()
same => n,Wait(1)
same => n,PlayBack(tt-monkeys)
same => n,Hangup()

exten => h,1,Hangup()

</pre>

Finalmente precisamos criar as entradas do voicemail, para isso altere o arquivo '''/etc/asterisk/voicemail.conf''' localize o contexto '''[default]''' e então adicione as entradas para seu voicemail, segue dois exemplos abaixo.
<pre>
101 => 123123,Mike Tesliuk
102 => 123123,Mike Tesliuk 2
</pre>

Feito isso, faça um restart no asterisk
/etc/init.d/asterisk restart

Agora você ja poderá fazer os testes, basicamente criamos as seguintes situações para serem testadas.

*1 Autenticação de usuários
*2 Chamada entre usuários
*3 Encaminhamento para caixa postal
*4 Acesso a caixa postal
*5 Acesso a conferência

OpenSIPs e Asterisk

2021-04-15T22:54:15Z

Admin:

{| class="wikitable"
|-
|Precisando de recursos de númeração para fazer seus testes ? contrate conosco em [www.brdvoz.com.br|BRDVOZ]
|-
|}

<table>
<tr><td style="background-color: red;"><b><font color=white> Falta realizar os ajustes / testes para o NAT no mais esta tudo funcionado adequadamente a principio </font></b></td></tr>
</table>

Este tutorial é baseado em um tutorial similar porém utilizando Kamailio e Freeswtich, se quiser verificar o tutorial original acesse http://kb.asipto.com/freeswitch:kamailio-3.1.x-freeswitch-1.0.6d-sbc.

Para esta implementação utilizamos Debian 7.0 amd64 , OpenSIPS 1.9 e Asterisk 1.8.23

==Funcionalidades==
Este tutorial tem por objetivo atingir as seguintes funcionalidades.
*Autenticação de usuário
*Registro de usuário
*Localização de usuário (encaminhamento de chamadas)
*Roteamento de chamadas

Através do Asterisk estenderemos estas funcionalidades agregando.
*Correio de voz (Voicemail)
*Conferencia
*SBC ( Pode ser utilizado para transcoding, esconder topologia, play de mensagens e tarifação )
*Outros serviços de media (Anuncios, Ura's e coisas do tipo)

==Definições==
Para um melhor entendimento da solução vamos expor aqui algumas definições de nosso sistema.
*Usuários locais terão ramais com 3 digitos (ex: 101, 102, 103)
*Identidade do correio de voz será o mesmo do ramal
*Serviços de media (acesso a voicemail e outros) receberão rotas de 4 digitos
*Opensips e Asterisk utilizarão o mesmo servidor (Neste caso IP: 10.254.254.6)
*Os serviços rodarão nas portas 5060 (opensips) , 5090 (Asterisk)

==Funcionamento==
A autenticação do usuário será realizada pelo OpenSIPs, quando uma chamada é autenticada então ela serguirá:
*Se o usuário de destino não está online a chamada será enviada para o Asterisk para função de correio de voz
*Se o usuário está online a chamada será encaminhada para o Asterisk, dest forma é possivel acionar funcionalidades como anuncios, definição de tempo de chamada, forçar codecs e outras funcionalidades.
*Asterisk envia a chamada novamente para o OpenSIPs que verificará no location e entregará a chamada para o usuário.
*Se a chamada não for atendida o Opensips irá re-encaminhar para o Asterisk direcionando para função de voicemail

==OpenSIPs==
Vamos iniciar o processo de instalação com o OpenSIPs, siga os procedimentos abaixo para evitar qualquer dificuldade.

===Dependencias===
Execute o comando abaixo para instalar todas as dependencias necessárias
<pre>
apt-get install gcc make libncurses5-dev libnewt-dev libxml2-dev unixodbc \
unixodbc-dev libmysqlclient15-dev libxmlrpc-c3-dev libexpat1-dev zlib1g-dev \
m4 bison flex libpcre3-dev mysql-server vim apache2-mpm-prefork libapache2-mod-php5 \
php5-mysql php5-xmlrpc php-pear ngrep g++ libjpeg62-dev libssl-dev
</pre>

Durante a instalação o sistema irá lhe perguntar a senha de root para o servidor MySQL é importante que você se lembre da mesma posteriormente pois utilizaremos a mesma.

===Compilando o OpenSIPs===
Para manter um padrão onde os dados estao vamos utilizar o diretório /usr/src/ para o download de código fonte.

cd /usr/src/
wget -c http://opensips.org/pub/opensips/1.9.1/src/opensips-1.9.1_src.tar.gz
tar -xzvf opensips-1.9.1_src.tar.gz
cd opensips-1.9.1-tls/
make menuconfig

Neste ponto o sistema irá abrir uma tela com algumas opções para selecionar, Acesse a primeira opção do menu, no submenu acesse a segunda opção ( Configure excluded modules ), selecione os módulos db_mysql , dialplan , mi_xmlrpc , presence e presence_xml

Agora volte ao submenu, e selecione a opção Save Changes, volte para o menu principal e selecione '''Compile and Install OpenSips''' , deixe que o sistema execute suas funções.

Ao finalizar a compilação você retornará ao menu, va na opção '''Exit and Save all changes'''

===Preparando a Configuração===

Antes de darmos inicio ao arquivo de configuração, vamos ajustar algumas questões, o opensips instala os arquivos (se voce nao alterar o parametro) em /usr, consequentemente as configurações ficam em /usr/etc , eu por padrão faço um link para o diretório /etc, assim acesso as configurações em /etc/opensips

ln -s /usr/etc/opensips /etc/

No caso do debian o script de inicialização utiliza um arquivo extra de configuração
cp packaging/debian/opensips.default /etc/default/opensips

Para o script de inicialização execute o comando abaixo
cp packaging/debian/opensips.init /etc/init.d/opensips
chmod +x /etc/init.d/opensips
update-rc.d opensips defaults

Edite o arquivo /etc/default/opensips , a altere o parametro '''RUN_OPENSIPS''' para yes

Você pode notar que no arquivo é mensionado o usuário de execução do opensips como opensips, então vamos ter de criar este usuário ( e grupo )

groupadd opensips
mkdir /var/run/opensips
useradd -d /var/run/opensips/ -s /bin/false -g opensips opensips
chown -R opensips.opensips /var/run/opensips

===Configurando o opensipsctl===
O opensipsctl (e opensipsdbctl) utilizam o arquivo de configuração /etc/opensips/opensipsctlrc, abaixo segue o conteúdo do arquivo. (Sugiro que você faça um backup dos arquivos originais para ter uma copia, existem parametros que você pode estudar depois).

<pre>
DBENGINE=MYSQL
DBHOST=localhost
DBNAME=opensips
DBRWUSER=opensips
DBRWPW="opensipsrw"
SIP_DOMAIN=10.254.254.6 ### caso voce esteja usando outro ip altere aqui

DBROOTUSER="root"
INSTALL_EXTRA_TABLES=ask
ALIASES_TYPE="DB"
MI_CONNECTOR=FIFO:/tmp/opensips_fifo
# VERIFY_ACL=1
# ACL_GROUPS="local ld int voicemail free-pstn"
# VERBOSE=1
# STORE_PLAINTEXT_PW=0
# NOHLPRINT=1
PID_FILE=/var/run/opensips/opensips.pid
</pre>

===Criando o banco de dados===
Agora que temos nosso arquivo configurado vamos fazer a criação do banco de dados, execute o comando abaixo.
<pre>
opensipsdbctl create opensips
</pre>

O sistema irá lhe perguntar algumas coisas, responda Y (sim) para todas para que ele instale todas as tabelas, não usaremos todas elas, mas desta forma você fica com praticamente tudo criado para o caso de uma expansão dos recursos.

===Instalando o RTP Proxy===
<pre>
cd /usr/src/
wget -c http://b2bua.org/chrome/site/rtpproxy-1.2.1.tar.gz
tar -xzvf rtpproxy-1.2.1.tar.gz
cd rtpproxy-1.2.1
./configure
make
make install
groupadd rtpproxy
useradd -d /var/run/rtpproxy -s /bin/true -g rtpproxy rtpproxy
mkdir /var/log/rtpproxy
mkdir /var/run/rtpproxy
chown -R rtpproxy.rtpproxy /var/log/rtpproxy
chown -R rtpproxy.rtpproxy /var/run/rtpproxy
</pre>

====Arquivo de inicialização====
'''/etc/init.d/rtpproxy'''
<pre>
#!/bin/bash
#
# Este script e de autoria de Mike Tesliuk
# qualquer falha no mesmo por favor informe
# atraves do email mike (a) tesliuk.com
#
### BEGIN INIT INFO
# Provides: rtpproxy
# Required-Start: $syslog $network $local_fs $time
# Required-Stop: $syslog $network $local_fs
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start the RTPPROXY server
# Description: Start the RTPPROXY server
### END INIT INFO

PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin
USELOG=1
USER=rtpproxy
# Altere o ip abaixo para o ip de seu sistema
IPADDR="10.254.254.6"

. /lib/lsb/init-functions

start(){
echo "Iniciando RTP PROXY "
if [ -z $(pidof rtpproxy) ]; then
if [ "${USELOG}" = "1" ]; then
echo "Iniciando com LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /var/log/rtpproxy/rtpproxy.log &
else
echo "Iniciando sem LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /dev/null
fi

if [ -n $(pidof rtpproxy) ]; then
echo "START OK"
fi
else
echo "Processo ja em execucao"
fi
}

stop(){

if [ -z $(pidof rtpproxy) ]; then
echo "Processo nao encontrado"
else
kill -9 $(pidof rtpproxy)
if [ -n $(pidof rtpproxy) ]; then
echo "STOP OK"
else
echo "Falha em realizar stop do servico"
fi

fi
}

case $1 in
start)
start
;;
stop)
stop
;;
restart)
stop
start

;;
*)
echo "Utilize: stop | start | restart"
;;
esac

</pre>

Vamos dar permissao e colocar na inicialização
chmod +x /etc/init.d/rtpproxy
update-rc.d rtpproxy defaults
/etc/init.d/rtpproxy start

===Criando o arquivo opensips.cfg===
O arquivo opensips.cfg é a onde a coisa toda acontece para o opensips, claro que ele dependerá de informações que estarão no banco de dados, mas é onde criamos todas as nossas rotas e validações.

<pre>
####### Global Parameters #########
debug=3
log_stderror=no
log_facility=LOG_LOCAL0

fork=yes
children=4

/* Descomente as linhas abaixo para ativar o debug */
#debug=7
#fork=no
#log_stderror=yes

/* Comente a linha abaixo para ativar a descoberta automatica de enderecos locais
, isso significa que o sistema ira verificar todos os ips ativos e hosts e entao ativara
o protocolo para todos eles */
auto_aliases=no

/* Defina aqui o ip a ser utilizado */
listen=udp:10.254.254.6:5060 # Altere este IP para o seu ambiente

/* Nao usaremos sip por tcp nem tls neste script */
disable_tcp=yes

disable_tls=yes

####### Secao de modulos ########

#set module path
mpath="/usr//lib64/opensips/modules/"

loadmodule "signaling.so"
loadmodule "sl.so"
loadmodule "tm.so"
modparam("tm", "fr_timer", 5)
modparam("tm", "fr_inv_timer", 30)
modparam("tm", "restart_fr_on_each_reply", 0)
modparam("tm", "onreply_avp_mode", 1)

loadmodule "rr.so"
/* do not append from tag to the RR (no need for this script) */
modparam("rr", "append_fromtag", 0)

loadmodule "maxfwd.so"
loadmodule "sipmsgops.so"
loadmodule "mi_fifo.so"
modparam("mi_fifo", "fifo_name", "/tmp/opensips_fifo")
modparam("mi_fifo", "fifo_mode", 0666)

loadmodule "db_mysql.so"

loadmodule "uri.so"
modparam("uri", "use_uri_table", 0)

loadmodule "usrloc.so"
modparam("usrloc", "nat_bflag", "FLB_NATB")
modparam("usrloc", "db_mode", 2)
modparam("usrloc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "registrar.so"
modparam("registrar", "tcp_persistent_flag", "TCP_PERSISTENT")

/* Descomente a linha abaixo para nao permitir mais de 10 contatos por conta */
#modparam("registrar", "max_contacts", 10)

loadmodule "acc.so"
/* Quais eventos deverao ser registrados ? */
modparam("acc", "early_media", 0)
modparam("acc", "report_cancels", 0)
/* por padrao nos nao ajustamos a direcao em requisicoes sequencias,
se voce deseja usar este recurso tenha certeza de ativar o "appen_fromtag"
para o modulo "rr" */
modparam("acc", "detect_direction", 0)
modparam("acc", "failed_transaction_flag", "FLT_ACCFAILED")
/* Gatilhos para accounting (flags) */
modparam("acc", "log_flag", "FLT_ACC")
modparam("acc", "log_missed_flag", "FLT_ACCMISSED")
modparam("acc", "log_extra",
"src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd")
modparam("acc", "db_flag", "FLT_ACC")
modparam("acc", "db_missed_flag", "FLT_ACCMISSED")
modparam("acc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("acc", "db_extra", "src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd" )

loadmodule "auth.so"
loadmodule "auth_db.so"
modparam("auth_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("auth_db", "calculate_ha1", yes)
modparam("auth_db", "password_column", "password")
modparam("auth_db", "load_credentials", "")

loadmodule "permissions.so"
modparam("permissions", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "alias_db.so"
modparam("alias_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "presence.so"
modparam("presence", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

#loadmodule "presence_xml.so"

loadmodule "dialog.so"
modparam("dialog", "db_mode", 2)
modparam("dialog", "db_url","mysql://opensips:opensipsrw@localhost/opensips")
modparam("dialog", "dlg_match_mode", 1)
#modparam("dialog", "default_timeout", 60)

loadmodule "siptrace.so"
modparam("siptrace", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("siptrace", "trace_flag", 22)
modparam("siptrace", "traced_user_avp", "$avp(s:traceuser)")

loadmodule "nathelper.so"
modparam("nathelper", "natping_interval", 30)
modparam("nathelper", "ping_nated_only", 1)
modparam("nathelper", "sipping_bflag", "FLB_NATSIPPING")
modparam("nathelper", "sipping_from", "sip:pinger@10.254.254.6") # Altere o ip para o ip do servidor
modparam("nathelper|registrar", "received_avp", "$avp(RECEIVED)")

loadmodule "rtpproxy.so"
modparam("rtpproxy", "rtpproxy_sock", "udp:127.0.0.1:7722")

####### Logica de roteamento ########

route {

if (!mf_process_maxfwd_header("3")) {
send_reply("483","looping");
exit;
}

xlog("REQUISICAO RECEBIDA, ENVIANDO PARA REQINIT");
# Checagem inicial por requisicao
route(REQINIT);

xlog("ENVIANDO PARA NAT");
# Deteccao de nat
route(NAT);

xlog("ENVIANDO PARA WITHINDLG");
# Gerenciando requisicaoes com dialog
route(WITHINDLG);

# Manipulando requisicoes iniciais (nao consta To tag)

# Processando CANCEL

if(is_method("CANCEL")){
xlog("METHOD CANCEL");
if(t_check_trans()){
t_relay();
}
exit;
}

t_check_trans();

# Enviando para autenticacao
xlog("ENVIANDO PARA AUTENTICACAO");
route(AUTH);

# gravando rota para formacao dos dialogs (caso sejam roteados)
# removemos qualquer cabecalho de rota pre carregado
remove_hf("Route");
if(is_method("INVITE|SUBSCRIBE")){
xlog("METHOD INVITE OU SIBSCRIBE");
record_route();
}

# Contabilizando (acc) INVITES
if(is_method("INVITE")){
xlog("METHOD INVITE, FAZENDOA ACC");
setflag(FLT_ACC);
}

# Enviando chamada para destinos externos
xlog("ENVIANDO PARA SIPOUT");
route(SIPOUT);

# Requisicoes para dominio local

# Roteando requisicoes de PRESENCE
xlog("ENVIANDO PARA PRESENCE");

route(PRESENCE);

# Gerenciando pedidos de registro
xlog("ENVIANDO PARA REGISTRAR");
route(REGISTRAR);

if($ru==""){
xlog("ru --> vazio");
# Requisicao sem usuario na RURI
sl_send_reply("484", "Address Incomplete");
}

# Enviando requisicao para PSTN
xlog("ENVIANDO PARA PSTN");
route(PSTN);

# Salvando informacao de quem originou a chamad
$avp(callee)=$rU;
xlog("ENVIANDO PARA DISPATCH PSTN");
route(FSDISPATCH);

# Servico de localizacao de usuario
route(LOCATION);

# Efetuando o relay (encaminhamento)
route(RELAY);

}

route[RELAY] {
if(check_route_param("nat=yes")){
setbflag(FLB_NATB);
}

if(isflagset(FLT_NATS) || isbflagset(FLB_NATB)){
#route(RTPPROXY);
}

# if(is_method("INVITE")){
# t_on_reply("REPLY_ONE");
# t_on_failure("FAIL_ONE");
# }

xlog("AQUI TENTAMOS ENVIAR A CHAMADA $fU $tU");
if(!t_relay()){
xlog("FALHA EM ENVIAR A CHAMADA, NAO FOI POSSIVEL FAZER O RELAY");
sl_reply_error();
}
xlog("CHAMADA FOI ENVIADA AQUI, QUAL O ERRO ENTAO");

exit;
}

route[REQINIT] {
if(!mf_process_maxfwd_header("10")){
sl_send_reply("483", "Too Many Hops");
exit;
}

}

route[WITHINDLG] {
if(has_totag()){
if(loose_route()){
if(is_method("BYE")){
setflag(FLT_ACC);
setflag(FLT_ACCFAILED);
}
route(RELAY);
}else{
if(is_method("SUBSCRIBE") && uri==myself) {
# requisicao de subscribe pre-estabelecida
route(PRESENCE);
exit;
}

if(is_method("ACK")){
if(t_check_trans()){
t_relay();
exit;
}
}else{
# ACK para transacao nao encontrada, ignoramos...
exit;

}

sl_send_reply("404", "Not Here");

}
exit;
}
}

route[REGISTRAR] {

if(is_method("REGISTER")){
if(isflagset(FLT_NATS)){
setbflag(FLB_NATB);
}

if(!save("location")){
sl_reply_error();
}

exit;
}

}

route[LOCATION] {

alias_db_lookup("dbaliases");
if(!lookup("location")){
switch($rc) {
case -1:
case -3:
t_newtran();
t_reply("404","Not Found");
exit;
case -2:
sl_send_reply("405", "Method Not Allowed");
exit;
}
}

if(is_method("INVITE")){
setflag(FLT_ACCMISSED);
}

}

route[PRESENCE] {
if(!is_method("PUBLISH|SUBSCRIBE")){
return;
}

if(!t_newtran()){
sl_reply_error();
exit;
}

if(is_method("PUBLISH")){
handle_publish();
}else if(is_method("SUBSCRIBE")){
handle_subscribe();
}
exit;

}

route[AUTH]{
xlog("PEDIDO DE AUTENTICACAO");
if(is_method("REGISTER")){
# atentica pedidos de registro
if(!www_authorize("", "subscriber")){
www_challenge("", "0");
exit;
}

if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if(route(FSINBOUND)){
return;
}

if(check_source_address("0")){
return;
}

if(from_uri==myself){
if(!proxy_authorize("", "subscriber")){
proxy_challenge("","0");
exit;
}

if(is_method("PUBLISH")){
if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if($au!=$fU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}
}

# Validamos (autenticamos) o usuario
consume_credentials();
}else{

# usuario nao e local, vamos negar
if(!uri==myself){
sl_send_reply("403", "Not relaying");
exit;
}
}
}

return;
}

route[NAT] {
force_rport();
if(nat_uac_test("19")){
if(method=="REGISTER"){
fix_nated_register();
}else{
fix_nated_contact();
}
setflag(FLT_NATS);
}

return;
}

route[RTPPROXY] {
if(is_method("BYE")){
unforce_rtp_proxy();
}else if(is_method("INVITE")){
engage_rtp_proxy();
}

if(!has_totag()){

if(!check_route_param("nat=yes")){
add_rr_param(";nat=yes");
xlog("NAT yes NAO ENCONTRADO");
}
}

return;
}

route[SIPOUT]{
if(!uri==myself){
append_hf("P-hint: outbound\r\n");
route(RELAY);
}
}

route[PSTN]{
# neste caso apenas para exemplificar um uso simples
# vamos fazer o redirecionamento par ao asterisk
# realizar a dicagem da chamada

if(!($rU=~"^(\+|00)[1-9][0-9]{3,20}$"))
return;

## a regra acima aceita para discagem externa qualquer numero
# comecado com 00 ou +
#

if(from_uri!=myself){
sl_send_reply("403", "Not Allowed");
exit;
}

$ru = "sip:" + $rU + "@" + "10.254.254.6:5090";
xlog("NOVO DESTINO: $ru");
route(RELAY);
exit;

}

route[XMLRPC]{
# nao vamos implementar esta funcionalidade
return;
}

route[FSINBOUND] {
# verificar para validar o ip do asterisk:porta
# se bater , responder com return 1;
if($si=="10.254.254.6" && $sp=="5090"){
return(1);
}else{
return(-1);
}
}

route[FSDISPATCH] {

if(!is_method("INVITE")){
return;
}

if(route(FSINBOUND)){
return;
}

xlog("CAIMOS NO SWITCH, VAMOS LOCALIZAR O PERFIL DA CHAMADA $rU");

if($rU =~ "^41$"){
xlog("SWITCH expressa comeca e termina em 41");
#regra de menu de voicemail, apenas
# usuarios autenticados
if($au==""){
sl_send_reply("403", "Not Allowed");
exit;
}

$rU = "vma-" + $au;
}else if($rU =~ "^441[0-9][0-9]$"){
xlog("SWTICH OPCA 441XX ");
# numero discado comeca com 441 seguido de dois digitos
# chamada direta para inbox do voicemail
strip(2);
route(FSVBOX);
}else if($rU =~ "^433[01][0-9][0-9]$"){
xlog("SWITCH OPCAO 433[01]XX");
# numero comecado em 443, seguido de 0 ou 1, mais dois digitos
# sistema de conferencia
strip(2);
}else if($rU =~ "^45[0-9]+$"){
xlog("SWTICH OPCAO 45X.");
#numero comecado com 45, seguindo de numeros;
strip(2);
}else{
xlog("OPCAO DEFAULT DO SWITCH");
# usuario offline, enviando para voicemail
if(!registered("location")){
route(FSVBOX);
exit;
}

# usuario online, fazendo bridging
xlog("USUARIO ESTA ONLINE VAMOS FAZER BRIDGE");
prefix("kb-");
if(is_method("INVITE")){
t_on_failure("FAIL_FSVBOX");
}
}
route(FSRELAY);
exit;
}

route[FSVBOX]{
xlog("ENVIANDO PARA FSVBOX");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($rU =~ "^441[0-9][0-9]"){
strip(2);
}
prefix("vm-");
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;
}

route[FSRELAY] {
xlog("ENVIANDO PARA FSRELAY");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;

}

branch_route[BRANCH_ONE]{
xlog("new branch at $ru");
}

onreply_route[REPLY_ONE]{
xlog("Incoming reply");
if((isflagset(FLT_NATS) || isbflagset(FLB_NATB) && status =~ "(183)|(2[0-9][0-9])")){
#rtpproxy_offer();

}
if(isbflagset(FLB_NATB)){
fix_nated_contact();
}

}

failure_route[FAIL_ONE]{
xlog("FAILURE ROUTE FAIL_ONE");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

}

failure_route[FAIL_FSVBOX]{
xlog("FAILURE ROUTE FAIL_FSVBOX");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

if(t_check_status("486|408|480")){
$rU = $avp(callee);
$var(newbranch) = 1;
route(FSVBOX);
}
}

</pre>

==Testes com Opensips (registro)==

Antes de podermos testar precisamos iniciar o serviço, no momento estamos com ele operando em modo debug, então a inicialização deve ser realizada com o comando abaixo
/etc/init.d/opensips debug

Abra uma nova sessão no servidor e então vamos criar os usuários
opensipsctl add 101 101
opensipsctl add 102 102
opensipsctl add 103 103

usuario 101 com senha 101 e assim por diante

Faça a onexão com seu softphone, aqui para testes utilizei o jitsi e o zoiper, neste momento vamos apenas fazer o registro do usuário para testar a autenticação, se você tentar realizar uma discagem não funcionará pois neste caso o processo depende do Asterisk que ainda não está configurado, vamos dar inicio nesta configuração agora.

==Asterisk==
Não vamos dar muitos detalhes da instalação do asterisk aqui, a ideia é simplesmente ter o mesmo funcionando da forma que necessitamos.
apt-get install asterisk

Após a instalação , abra o arquivo /etc/asterisk/sip.conf, localize a linha '''udpbindaddr=0.0.0.0''' e altere para '''udpbindaddr=0.0.0.0:5090''' , depois ao fim do arquivo adicione.
<pre>
[opensips]
type=peer
host=10.254.254.6
port=5060
qualify=yes
context=opensips
insecure=port,invite
canreinvite=no
</pre>

Agora abra o arquivo '''/etc/asterisk/extensions.conf''' , crie no fim do arquivo a seguinte entrada.
<pre>
[opensips]

exten => _kb-1XX,1,NoOp(CHAMADA INTERNA - FAZER BRIDGE - ${CALLERID(num)} ${EXTEN:3})
same => n,Dial(SIP/opensips/${EXTEN:3})
same => n,Goto(opensips,vm-${EXTEN:3},1)
same => n,Hangup()

exten => _vm-1XX,1,NoOp(CHAMADA PARA VOICEMAIL)
same => n,Voicemail(${EXTEN:3}@default)
same => n,Hangup()

exten => _vma-1XX,1,NoOp(CHAMADA PARA VOICEMAIL - ADMINISTRATIVO)
same => n,VoicemailMain(${EXTEN:4}@default)
same => n,Hangup()

exten => _3[01]XX,1,NoOp(CHAMADA PARA CONFERENCIA)
same => n,Answer()
same => n,ConfBridge(${EXTEN},cM1)
same => n,Hangup()

exten => _00.,1,NoOp(CHAMADA PARA PSTN)
same => n,Wait(2)
same => n,Answer()
same => n,Wait(1)
same => n,PlayBack(tt-monkeys)
same => n,Hangup()

exten => h,1,Hangup()

</pre>

Finalmente precisamos criar as entradas do voicemail, para isso altere o arquivo '''/etc/asterisk/voicemail.conf''' localize o contexto '''[default]''' e então adicione as entradas para seu voicemail, segue dois exemplos abaixo.
<pre>
101 => 123123,Mike Tesliuk
102 => 123123,Mike Tesliuk 2
</pre>

Feito isso, faça um restart no asterisk
/etc/init.d/asterisk restart

Agora você ja poderá fazer os testes, basicamente criamos as seguintes situações para serem testadas.

*1 Autenticação de usuários
*2 Chamada entre usuários
*3 Encaminhamento para caixa postal
*4 Acesso a caixa postal
*5 Acesso a conferência

OpenSIPs e Asterisk

2021-04-15T22:53:51Z

Admin:

{| class="wikitable"
|-
|Precisando de recursos de númeração para fazer seus testes ? contrate conosco em www.brdvoz.com.br
|-
|}

<table>
<tr><td style="background-color: red;"><b><font color=white> Falta realizar os ajustes / testes para o NAT no mais esta tudo funcionado adequadamente a principio </font></b></td></tr>
</table>

Este tutorial é baseado em um tutorial similar porém utilizando Kamailio e Freeswtich, se quiser verificar o tutorial original acesse http://kb.asipto.com/freeswitch:kamailio-3.1.x-freeswitch-1.0.6d-sbc.

Para esta implementação utilizamos Debian 7.0 amd64 , OpenSIPS 1.9 e Asterisk 1.8.23

==Funcionalidades==
Este tutorial tem por objetivo atingir as seguintes funcionalidades.
*Autenticação de usuário
*Registro de usuário
*Localização de usuário (encaminhamento de chamadas)
*Roteamento de chamadas

Através do Asterisk estenderemos estas funcionalidades agregando.
*Correio de voz (Voicemail)
*Conferencia
*SBC ( Pode ser utilizado para transcoding, esconder topologia, play de mensagens e tarifação )
*Outros serviços de media (Anuncios, Ura's e coisas do tipo)

==Definições==
Para um melhor entendimento da solução vamos expor aqui algumas definições de nosso sistema.
*Usuários locais terão ramais com 3 digitos (ex: 101, 102, 103)
*Identidade do correio de voz será o mesmo do ramal
*Serviços de media (acesso a voicemail e outros) receberão rotas de 4 digitos
*Opensips e Asterisk utilizarão o mesmo servidor (Neste caso IP: 10.254.254.6)
*Os serviços rodarão nas portas 5060 (opensips) , 5090 (Asterisk)

==Funcionamento==
A autenticação do usuário será realizada pelo OpenSIPs, quando uma chamada é autenticada então ela serguirá:
*Se o usuário de destino não está online a chamada será enviada para o Asterisk para função de correio de voz
*Se o usuário está online a chamada será encaminhada para o Asterisk, dest forma é possivel acionar funcionalidades como anuncios, definição de tempo de chamada, forçar codecs e outras funcionalidades.
*Asterisk envia a chamada novamente para o OpenSIPs que verificará no location e entregará a chamada para o usuário.
*Se a chamada não for atendida o Opensips irá re-encaminhar para o Asterisk direcionando para função de voicemail

==OpenSIPs==
Vamos iniciar o processo de instalação com o OpenSIPs, siga os procedimentos abaixo para evitar qualquer dificuldade.

===Dependencias===
Execute o comando abaixo para instalar todas as dependencias necessárias
<pre>
apt-get install gcc make libncurses5-dev libnewt-dev libxml2-dev unixodbc \
unixodbc-dev libmysqlclient15-dev libxmlrpc-c3-dev libexpat1-dev zlib1g-dev \
m4 bison flex libpcre3-dev mysql-server vim apache2-mpm-prefork libapache2-mod-php5 \
php5-mysql php5-xmlrpc php-pear ngrep g++ libjpeg62-dev libssl-dev
</pre>

Durante a instalação o sistema irá lhe perguntar a senha de root para o servidor MySQL é importante que você se lembre da mesma posteriormente pois utilizaremos a mesma.

===Compilando o OpenSIPs===
Para manter um padrão onde os dados estao vamos utilizar o diretório /usr/src/ para o download de código fonte.

cd /usr/src/
wget -c http://opensips.org/pub/opensips/1.9.1/src/opensips-1.9.1_src.tar.gz
tar -xzvf opensips-1.9.1_src.tar.gz
cd opensips-1.9.1-tls/
make menuconfig

Neste ponto o sistema irá abrir uma tela com algumas opções para selecionar, Acesse a primeira opção do menu, no submenu acesse a segunda opção ( Configure excluded modules ), selecione os módulos db_mysql , dialplan , mi_xmlrpc , presence e presence_xml

Agora volte ao submenu, e selecione a opção Save Changes, volte para o menu principal e selecione '''Compile and Install OpenSips''' , deixe que o sistema execute suas funções.

Ao finalizar a compilação você retornará ao menu, va na opção '''Exit and Save all changes'''

===Preparando a Configuração===

Antes de darmos inicio ao arquivo de configuração, vamos ajustar algumas questões, o opensips instala os arquivos (se voce nao alterar o parametro) em /usr, consequentemente as configurações ficam em /usr/etc , eu por padrão faço um link para o diretório /etc, assim acesso as configurações em /etc/opensips

ln -s /usr/etc/opensips /etc/

No caso do debian o script de inicialização utiliza um arquivo extra de configuração
cp packaging/debian/opensips.default /etc/default/opensips

Para o script de inicialização execute o comando abaixo
cp packaging/debian/opensips.init /etc/init.d/opensips
chmod +x /etc/init.d/opensips
update-rc.d opensips defaults

Edite o arquivo /etc/default/opensips , a altere o parametro '''RUN_OPENSIPS''' para yes

Você pode notar que no arquivo é mensionado o usuário de execução do opensips como opensips, então vamos ter de criar este usuário ( e grupo )

groupadd opensips
mkdir /var/run/opensips
useradd -d /var/run/opensips/ -s /bin/false -g opensips opensips
chown -R opensips.opensips /var/run/opensips

===Configurando o opensipsctl===
O opensipsctl (e opensipsdbctl) utilizam o arquivo de configuração /etc/opensips/opensipsctlrc, abaixo segue o conteúdo do arquivo. (Sugiro que você faça um backup dos arquivos originais para ter uma copia, existem parametros que você pode estudar depois).

<pre>
DBENGINE=MYSQL
DBHOST=localhost
DBNAME=opensips
DBRWUSER=opensips
DBRWPW="opensipsrw"
SIP_DOMAIN=10.254.254.6 ### caso voce esteja usando outro ip altere aqui

DBROOTUSER="root"
INSTALL_EXTRA_TABLES=ask
ALIASES_TYPE="DB"
MI_CONNECTOR=FIFO:/tmp/opensips_fifo
# VERIFY_ACL=1
# ACL_GROUPS="local ld int voicemail free-pstn"
# VERBOSE=1
# STORE_PLAINTEXT_PW=0
# NOHLPRINT=1
PID_FILE=/var/run/opensips/opensips.pid
</pre>

===Criando o banco de dados===
Agora que temos nosso arquivo configurado vamos fazer a criação do banco de dados, execute o comando abaixo.
<pre>
opensipsdbctl create opensips
</pre>

O sistema irá lhe perguntar algumas coisas, responda Y (sim) para todas para que ele instale todas as tabelas, não usaremos todas elas, mas desta forma você fica com praticamente tudo criado para o caso de uma expansão dos recursos.

===Instalando o RTP Proxy===
<pre>
cd /usr/src/
wget -c http://b2bua.org/chrome/site/rtpproxy-1.2.1.tar.gz
tar -xzvf rtpproxy-1.2.1.tar.gz
cd rtpproxy-1.2.1
./configure
make
make install
groupadd rtpproxy
useradd -d /var/run/rtpproxy -s /bin/true -g rtpproxy rtpproxy
mkdir /var/log/rtpproxy
mkdir /var/run/rtpproxy
chown -R rtpproxy.rtpproxy /var/log/rtpproxy
chown -R rtpproxy.rtpproxy /var/run/rtpproxy
</pre>

====Arquivo de inicialização====
'''/etc/init.d/rtpproxy'''
<pre>
#!/bin/bash
#
# Este script e de autoria de Mike Tesliuk
# qualquer falha no mesmo por favor informe
# atraves do email mike (a) tesliuk.com
#
### BEGIN INIT INFO
# Provides: rtpproxy
# Required-Start: $syslog $network $local_fs $time
# Required-Stop: $syslog $network $local_fs
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start the RTPPROXY server
# Description: Start the RTPPROXY server
### END INIT INFO

PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin
USELOG=1
USER=rtpproxy
# Altere o ip abaixo para o ip de seu sistema
IPADDR="10.254.254.6"

. /lib/lsb/init-functions

start(){
echo "Iniciando RTP PROXY "
if [ -z $(pidof rtpproxy) ]; then
if [ "${USELOG}" = "1" ]; then
echo "Iniciando com LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /var/log/rtpproxy/rtpproxy.log &
else
echo "Iniciando sem LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /dev/null
fi

if [ -n $(pidof rtpproxy) ]; then
echo "START OK"
fi
else
echo "Processo ja em execucao"
fi
}

stop(){

if [ -z $(pidof rtpproxy) ]; then
echo "Processo nao encontrado"
else
kill -9 $(pidof rtpproxy)
if [ -n $(pidof rtpproxy) ]; then
echo "STOP OK"
else
echo "Falha em realizar stop do servico"
fi

fi
}

case $1 in
start)
start
;;
stop)
stop
;;
restart)
stop
start

;;
*)
echo "Utilize: stop | start | restart"
;;
esac

</pre>

Vamos dar permissao e colocar na inicialização
chmod +x /etc/init.d/rtpproxy
update-rc.d rtpproxy defaults
/etc/init.d/rtpproxy start

===Criando o arquivo opensips.cfg===
O arquivo opensips.cfg é a onde a coisa toda acontece para o opensips, claro que ele dependerá de informações que estarão no banco de dados, mas é onde criamos todas as nossas rotas e validações.

<pre>
####### Global Parameters #########
debug=3
log_stderror=no
log_facility=LOG_LOCAL0

fork=yes
children=4

/* Descomente as linhas abaixo para ativar o debug */
#debug=7
#fork=no
#log_stderror=yes

/* Comente a linha abaixo para ativar a descoberta automatica de enderecos locais
, isso significa que o sistema ira verificar todos os ips ativos e hosts e entao ativara
o protocolo para todos eles */
auto_aliases=no

/* Defina aqui o ip a ser utilizado */
listen=udp:10.254.254.6:5060 # Altere este IP para o seu ambiente

/* Nao usaremos sip por tcp nem tls neste script */
disable_tcp=yes

disable_tls=yes

####### Secao de modulos ########

#set module path
mpath="/usr//lib64/opensips/modules/"

loadmodule "signaling.so"
loadmodule "sl.so"
loadmodule "tm.so"
modparam("tm", "fr_timer", 5)
modparam("tm", "fr_inv_timer", 30)
modparam("tm", "restart_fr_on_each_reply", 0)
modparam("tm", "onreply_avp_mode", 1)

loadmodule "rr.so"
/* do not append from tag to the RR (no need for this script) */
modparam("rr", "append_fromtag", 0)

loadmodule "maxfwd.so"
loadmodule "sipmsgops.so"
loadmodule "mi_fifo.so"
modparam("mi_fifo", "fifo_name", "/tmp/opensips_fifo")
modparam("mi_fifo", "fifo_mode", 0666)

loadmodule "db_mysql.so"

loadmodule "uri.so"
modparam("uri", "use_uri_table", 0)

loadmodule "usrloc.so"
modparam("usrloc", "nat_bflag", "FLB_NATB")
modparam("usrloc", "db_mode", 2)
modparam("usrloc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "registrar.so"
modparam("registrar", "tcp_persistent_flag", "TCP_PERSISTENT")

/* Descomente a linha abaixo para nao permitir mais de 10 contatos por conta */
#modparam("registrar", "max_contacts", 10)

loadmodule "acc.so"
/* Quais eventos deverao ser registrados ? */
modparam("acc", "early_media", 0)
modparam("acc", "report_cancels", 0)
/* por padrao nos nao ajustamos a direcao em requisicoes sequencias,
se voce deseja usar este recurso tenha certeza de ativar o "appen_fromtag"
para o modulo "rr" */
modparam("acc", "detect_direction", 0)
modparam("acc", "failed_transaction_flag", "FLT_ACCFAILED")
/* Gatilhos para accounting (flags) */
modparam("acc", "log_flag", "FLT_ACC")
modparam("acc", "log_missed_flag", "FLT_ACCMISSED")
modparam("acc", "log_extra",
"src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd")
modparam("acc", "db_flag", "FLT_ACC")
modparam("acc", "db_missed_flag", "FLT_ACCMISSED")
modparam("acc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("acc", "db_extra", "src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd" )

loadmodule "auth.so"
loadmodule "auth_db.so"
modparam("auth_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("auth_db", "calculate_ha1", yes)
modparam("auth_db", "password_column", "password")
modparam("auth_db", "load_credentials", "")

loadmodule "permissions.so"
modparam("permissions", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "alias_db.so"
modparam("alias_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "presence.so"
modparam("presence", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

#loadmodule "presence_xml.so"

loadmodule "dialog.so"
modparam("dialog", "db_mode", 2)
modparam("dialog", "db_url","mysql://opensips:opensipsrw@localhost/opensips")
modparam("dialog", "dlg_match_mode", 1)
#modparam("dialog", "default_timeout", 60)

loadmodule "siptrace.so"
modparam("siptrace", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("siptrace", "trace_flag", 22)
modparam("siptrace", "traced_user_avp", "$avp(s:traceuser)")

loadmodule "nathelper.so"
modparam("nathelper", "natping_interval", 30)
modparam("nathelper", "ping_nated_only", 1)
modparam("nathelper", "sipping_bflag", "FLB_NATSIPPING")
modparam("nathelper", "sipping_from", "sip:pinger@10.254.254.6") # Altere o ip para o ip do servidor
modparam("nathelper|registrar", "received_avp", "$avp(RECEIVED)")

loadmodule "rtpproxy.so"
modparam("rtpproxy", "rtpproxy_sock", "udp:127.0.0.1:7722")

####### Logica de roteamento ########

route {

if (!mf_process_maxfwd_header("3")) {
send_reply("483","looping");
exit;
}

xlog("REQUISICAO RECEBIDA, ENVIANDO PARA REQINIT");
# Checagem inicial por requisicao
route(REQINIT);

xlog("ENVIANDO PARA NAT");
# Deteccao de nat
route(NAT);

xlog("ENVIANDO PARA WITHINDLG");
# Gerenciando requisicaoes com dialog
route(WITHINDLG);

# Manipulando requisicoes iniciais (nao consta To tag)

# Processando CANCEL

if(is_method("CANCEL")){
xlog("METHOD CANCEL");
if(t_check_trans()){
t_relay();
}
exit;
}

t_check_trans();

# Enviando para autenticacao
xlog("ENVIANDO PARA AUTENTICACAO");
route(AUTH);

# gravando rota para formacao dos dialogs (caso sejam roteados)
# removemos qualquer cabecalho de rota pre carregado
remove_hf("Route");
if(is_method("INVITE|SUBSCRIBE")){
xlog("METHOD INVITE OU SIBSCRIBE");
record_route();
}

# Contabilizando (acc) INVITES
if(is_method("INVITE")){
xlog("METHOD INVITE, FAZENDOA ACC");
setflag(FLT_ACC);
}

# Enviando chamada para destinos externos
xlog("ENVIANDO PARA SIPOUT");
route(SIPOUT);

# Requisicoes para dominio local

# Roteando requisicoes de PRESENCE
xlog("ENVIANDO PARA PRESENCE");

route(PRESENCE);

# Gerenciando pedidos de registro
xlog("ENVIANDO PARA REGISTRAR");
route(REGISTRAR);

if($ru==""){
xlog("ru --> vazio");
# Requisicao sem usuario na RURI
sl_send_reply("484", "Address Incomplete");
}

# Enviando requisicao para PSTN
xlog("ENVIANDO PARA PSTN");
route(PSTN);

# Salvando informacao de quem originou a chamad
$avp(callee)=$rU;
xlog("ENVIANDO PARA DISPATCH PSTN");
route(FSDISPATCH);

# Servico de localizacao de usuario
route(LOCATION);

# Efetuando o relay (encaminhamento)
route(RELAY);

}

route[RELAY] {
if(check_route_param("nat=yes")){
setbflag(FLB_NATB);
}

if(isflagset(FLT_NATS) || isbflagset(FLB_NATB)){
#route(RTPPROXY);
}

# if(is_method("INVITE")){
# t_on_reply("REPLY_ONE");
# t_on_failure("FAIL_ONE");
# }

xlog("AQUI TENTAMOS ENVIAR A CHAMADA $fU $tU");
if(!t_relay()){
xlog("FALHA EM ENVIAR A CHAMADA, NAO FOI POSSIVEL FAZER O RELAY");
sl_reply_error();
}
xlog("CHAMADA FOI ENVIADA AQUI, QUAL O ERRO ENTAO");

exit;
}

route[REQINIT] {
if(!mf_process_maxfwd_header("10")){
sl_send_reply("483", "Too Many Hops");
exit;
}

}

route[WITHINDLG] {
if(has_totag()){
if(loose_route()){
if(is_method("BYE")){
setflag(FLT_ACC);
setflag(FLT_ACCFAILED);
}
route(RELAY);
}else{
if(is_method("SUBSCRIBE") && uri==myself) {
# requisicao de subscribe pre-estabelecida
route(PRESENCE);
exit;
}

if(is_method("ACK")){
if(t_check_trans()){
t_relay();
exit;
}
}else{
# ACK para transacao nao encontrada, ignoramos...
exit;

}

sl_send_reply("404", "Not Here");

}
exit;
}
}

route[REGISTRAR] {

if(is_method("REGISTER")){
if(isflagset(FLT_NATS)){
setbflag(FLB_NATB);
}

if(!save("location")){
sl_reply_error();
}

exit;
}

}

route[LOCATION] {

alias_db_lookup("dbaliases");
if(!lookup("location")){
switch($rc) {
case -1:
case -3:
t_newtran();
t_reply("404","Not Found");
exit;
case -2:
sl_send_reply("405", "Method Not Allowed");
exit;
}
}

if(is_method("INVITE")){
setflag(FLT_ACCMISSED);
}

}

route[PRESENCE] {
if(!is_method("PUBLISH|SUBSCRIBE")){
return;
}

if(!t_newtran()){
sl_reply_error();
exit;
}

if(is_method("PUBLISH")){
handle_publish();
}else if(is_method("SUBSCRIBE")){
handle_subscribe();
}
exit;

}

route[AUTH]{
xlog("PEDIDO DE AUTENTICACAO");
if(is_method("REGISTER")){
# atentica pedidos de registro
if(!www_authorize("", "subscriber")){
www_challenge("", "0");
exit;
}

if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if(route(FSINBOUND)){
return;
}

if(check_source_address("0")){
return;
}

if(from_uri==myself){
if(!proxy_authorize("", "subscriber")){
proxy_challenge("","0");
exit;
}

if(is_method("PUBLISH")){
if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if($au!=$fU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}
}

# Validamos (autenticamos) o usuario
consume_credentials();
}else{

# usuario nao e local, vamos negar
if(!uri==myself){
sl_send_reply("403", "Not relaying");
exit;
}
}
}

return;
}

route[NAT] {
force_rport();
if(nat_uac_test("19")){
if(method=="REGISTER"){
fix_nated_register();
}else{
fix_nated_contact();
}
setflag(FLT_NATS);
}

return;
}

route[RTPPROXY] {
if(is_method("BYE")){
unforce_rtp_proxy();
}else if(is_method("INVITE")){
engage_rtp_proxy();
}

if(!has_totag()){

if(!check_route_param("nat=yes")){
add_rr_param(";nat=yes");
xlog("NAT yes NAO ENCONTRADO");
}
}

return;
}

route[SIPOUT]{
if(!uri==myself){
append_hf("P-hint: outbound\r\n");
route(RELAY);
}
}

route[PSTN]{
# neste caso apenas para exemplificar um uso simples
# vamos fazer o redirecionamento par ao asterisk
# realizar a dicagem da chamada

if(!($rU=~"^(\+|00)[1-9][0-9]{3,20}$"))
return;

## a regra acima aceita para discagem externa qualquer numero
# comecado com 00 ou +
#

if(from_uri!=myself){
sl_send_reply("403", "Not Allowed");
exit;
}

$ru = "sip:" + $rU + "@" + "10.254.254.6:5090";
xlog("NOVO DESTINO: $ru");
route(RELAY);
exit;

}

route[XMLRPC]{
# nao vamos implementar esta funcionalidade
return;
}

route[FSINBOUND] {
# verificar para validar o ip do asterisk:porta
# se bater , responder com return 1;
if($si=="10.254.254.6" && $sp=="5090"){
return(1);
}else{
return(-1);
}
}

route[FSDISPATCH] {

if(!is_method("INVITE")){
return;
}

if(route(FSINBOUND)){
return;
}

xlog("CAIMOS NO SWITCH, VAMOS LOCALIZAR O PERFIL DA CHAMADA $rU");

if($rU =~ "^41$"){
xlog("SWITCH expressa comeca e termina em 41");
#regra de menu de voicemail, apenas
# usuarios autenticados
if($au==""){
sl_send_reply("403", "Not Allowed");
exit;
}

$rU = "vma-" + $au;
}else if($rU =~ "^441[0-9][0-9]$"){
xlog("SWTICH OPCA 441XX ");
# numero discado comeca com 441 seguido de dois digitos
# chamada direta para inbox do voicemail
strip(2);
route(FSVBOX);
}else if($rU =~ "^433[01][0-9][0-9]$"){
xlog("SWITCH OPCAO 433[01]XX");
# numero comecado em 443, seguido de 0 ou 1, mais dois digitos
# sistema de conferencia
strip(2);
}else if($rU =~ "^45[0-9]+$"){
xlog("SWTICH OPCAO 45X.");
#numero comecado com 45, seguindo de numeros;
strip(2);
}else{
xlog("OPCAO DEFAULT DO SWITCH");
# usuario offline, enviando para voicemail
if(!registered("location")){
route(FSVBOX);
exit;
}

# usuario online, fazendo bridging
xlog("USUARIO ESTA ONLINE VAMOS FAZER BRIDGE");
prefix("kb-");
if(is_method("INVITE")){
t_on_failure("FAIL_FSVBOX");
}
}
route(FSRELAY);
exit;
}

route[FSVBOX]{
xlog("ENVIANDO PARA FSVBOX");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($rU =~ "^441[0-9][0-9]"){
strip(2);
}
prefix("vm-");
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;
}

route[FSRELAY] {
xlog("ENVIANDO PARA FSRELAY");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;

}

branch_route[BRANCH_ONE]{
xlog("new branch at $ru");
}

onreply_route[REPLY_ONE]{
xlog("Incoming reply");
if((isflagset(FLT_NATS) || isbflagset(FLB_NATB) && status =~ "(183)|(2[0-9][0-9])")){
#rtpproxy_offer();

}
if(isbflagset(FLB_NATB)){
fix_nated_contact();
}

}

failure_route[FAIL_ONE]{
xlog("FAILURE ROUTE FAIL_ONE");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

}

failure_route[FAIL_FSVBOX]{
xlog("FAILURE ROUTE FAIL_FSVBOX");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

if(t_check_status("486|408|480")){
$rU = $avp(callee);
$var(newbranch) = 1;
route(FSVBOX);
}
}

</pre>

==Testes com Opensips (registro)==

Antes de podermos testar precisamos iniciar o serviço, no momento estamos com ele operando em modo debug, então a inicialização deve ser realizada com o comando abaixo
/etc/init.d/opensips debug

Abra uma nova sessão no servidor e então vamos criar os usuários
opensipsctl add 101 101
opensipsctl add 102 102
opensipsctl add 103 103

usuario 101 com senha 101 e assim por diante

Faça a onexão com seu softphone, aqui para testes utilizei o jitsi e o zoiper, neste momento vamos apenas fazer o registro do usuário para testar a autenticação, se você tentar realizar uma discagem não funcionará pois neste caso o processo depende do Asterisk que ainda não está configurado, vamos dar inicio nesta configuração agora.

==Asterisk==
Não vamos dar muitos detalhes da instalação do asterisk aqui, a ideia é simplesmente ter o mesmo funcionando da forma que necessitamos.
apt-get install asterisk

Após a instalação , abra o arquivo /etc/asterisk/sip.conf, localize a linha '''udpbindaddr=0.0.0.0''' e altere para '''udpbindaddr=0.0.0.0:5090''' , depois ao fim do arquivo adicione.
<pre>
[opensips]
type=peer
host=10.254.254.6
port=5060
qualify=yes
context=opensips
insecure=port,invite
canreinvite=no
</pre>

Agora abra o arquivo '''/etc/asterisk/extensions.conf''' , crie no fim do arquivo a seguinte entrada.
<pre>
[opensips]

exten => _kb-1XX,1,NoOp(CHAMADA INTERNA - FAZER BRIDGE - ${CALLERID(num)} ${EXTEN:3})
same => n,Dial(SIP/opensips/${EXTEN:3})
same => n,Goto(opensips,vm-${EXTEN:3},1)
same => n,Hangup()

exten => _vm-1XX,1,NoOp(CHAMADA PARA VOICEMAIL)
same => n,Voicemail(${EXTEN:3}@default)
same => n,Hangup()

exten => _vma-1XX,1,NoOp(CHAMADA PARA VOICEMAIL - ADMINISTRATIVO)
same => n,VoicemailMain(${EXTEN:4}@default)
same => n,Hangup()

exten => _3[01]XX,1,NoOp(CHAMADA PARA CONFERENCIA)
same => n,Answer()
same => n,ConfBridge(${EXTEN},cM1)
same => n,Hangup()

exten => _00.,1,NoOp(CHAMADA PARA PSTN)
same => n,Wait(2)
same => n,Answer()
same => n,Wait(1)
same => n,PlayBack(tt-monkeys)
same => n,Hangup()

exten => h,1,Hangup()

</pre>

Finalmente precisamos criar as entradas do voicemail, para isso altere o arquivo '''/etc/asterisk/voicemail.conf''' localize o contexto '''[default]''' e então adicione as entradas para seu voicemail, segue dois exemplos abaixo.
<pre>
101 => 123123,Mike Tesliuk
102 => 123123,Mike Tesliuk 2
</pre>

Feito isso, faça um restart no asterisk
/etc/init.d/asterisk restart

Agora você ja poderá fazer os testes, basicamente criamos as seguintes situações para serem testadas.

*1 Autenticação de usuários
*2 Chamada entre usuários
*3 Encaminhamento para caixa postal
*4 Acesso a caixa postal
*5 Acesso a conferência

OpenSIPs e Asterisk

2021-04-15T22:53:22Z

Admin:

{| class="wikitable"
|-
|Precisando de recursos de númeração para fazer seus testes ? contrate conosco em www.brdvoz.com.br|
|}

<table>
<tr><td style="background-color: red;"><b><font color=white> Falta realizar os ajustes / testes para o NAT no mais esta tudo funcionado adequadamente a principio </font></b></td></tr>
</table>

Este tutorial é baseado em um tutorial similar porém utilizando Kamailio e Freeswtich, se quiser verificar o tutorial original acesse http://kb.asipto.com/freeswitch:kamailio-3.1.x-freeswitch-1.0.6d-sbc.

Para esta implementação utilizamos Debian 7.0 amd64 , OpenSIPS 1.9 e Asterisk 1.8.23

==Funcionalidades==
Este tutorial tem por objetivo atingir as seguintes funcionalidades.
*Autenticação de usuário
*Registro de usuário
*Localização de usuário (encaminhamento de chamadas)
*Roteamento de chamadas

Através do Asterisk estenderemos estas funcionalidades agregando.
*Correio de voz (Voicemail)
*Conferencia
*SBC ( Pode ser utilizado para transcoding, esconder topologia, play de mensagens e tarifação )
*Outros serviços de media (Anuncios, Ura's e coisas do tipo)

==Definições==
Para um melhor entendimento da solução vamos expor aqui algumas definições de nosso sistema.
*Usuários locais terão ramais com 3 digitos (ex: 101, 102, 103)
*Identidade do correio de voz será o mesmo do ramal
*Serviços de media (acesso a voicemail e outros) receberão rotas de 4 digitos
*Opensips e Asterisk utilizarão o mesmo servidor (Neste caso IP: 10.254.254.6)
*Os serviços rodarão nas portas 5060 (opensips) , 5090 (Asterisk)

==Funcionamento==
A autenticação do usuário será realizada pelo OpenSIPs, quando uma chamada é autenticada então ela serguirá:
*Se o usuário de destino não está online a chamada será enviada para o Asterisk para função de correio de voz
*Se o usuário está online a chamada será encaminhada para o Asterisk, dest forma é possivel acionar funcionalidades como anuncios, definição de tempo de chamada, forçar codecs e outras funcionalidades.
*Asterisk envia a chamada novamente para o OpenSIPs que verificará no location e entregará a chamada para o usuário.
*Se a chamada não for atendida o Opensips irá re-encaminhar para o Asterisk direcionando para função de voicemail

==OpenSIPs==
Vamos iniciar o processo de instalação com o OpenSIPs, siga os procedimentos abaixo para evitar qualquer dificuldade.

===Dependencias===
Execute o comando abaixo para instalar todas as dependencias necessárias
<pre>
apt-get install gcc make libncurses5-dev libnewt-dev libxml2-dev unixodbc \
unixodbc-dev libmysqlclient15-dev libxmlrpc-c3-dev libexpat1-dev zlib1g-dev \
m4 bison flex libpcre3-dev mysql-server vim apache2-mpm-prefork libapache2-mod-php5 \
php5-mysql php5-xmlrpc php-pear ngrep g++ libjpeg62-dev libssl-dev
</pre>

Durante a instalação o sistema irá lhe perguntar a senha de root para o servidor MySQL é importante que você se lembre da mesma posteriormente pois utilizaremos a mesma.

===Compilando o OpenSIPs===
Para manter um padrão onde os dados estao vamos utilizar o diretório /usr/src/ para o download de código fonte.

cd /usr/src/
wget -c http://opensips.org/pub/opensips/1.9.1/src/opensips-1.9.1_src.tar.gz
tar -xzvf opensips-1.9.1_src.tar.gz
cd opensips-1.9.1-tls/
make menuconfig

Neste ponto o sistema irá abrir uma tela com algumas opções para selecionar, Acesse a primeira opção do menu, no submenu acesse a segunda opção ( Configure excluded modules ), selecione os módulos db_mysql , dialplan , mi_xmlrpc , presence e presence_xml

Agora volte ao submenu, e selecione a opção Save Changes, volte para o menu principal e selecione '''Compile and Install OpenSips''' , deixe que o sistema execute suas funções.

Ao finalizar a compilação você retornará ao menu, va na opção '''Exit and Save all changes'''

===Preparando a Configuração===

Antes de darmos inicio ao arquivo de configuração, vamos ajustar algumas questões, o opensips instala os arquivos (se voce nao alterar o parametro) em /usr, consequentemente as configurações ficam em /usr/etc , eu por padrão faço um link para o diretório /etc, assim acesso as configurações em /etc/opensips

ln -s /usr/etc/opensips /etc/

No caso do debian o script de inicialização utiliza um arquivo extra de configuração
cp packaging/debian/opensips.default /etc/default/opensips

Para o script de inicialização execute o comando abaixo
cp packaging/debian/opensips.init /etc/init.d/opensips
chmod +x /etc/init.d/opensips
update-rc.d opensips defaults

Edite o arquivo /etc/default/opensips , a altere o parametro '''RUN_OPENSIPS''' para yes

Você pode notar que no arquivo é mensionado o usuário de execução do opensips como opensips, então vamos ter de criar este usuário ( e grupo )

groupadd opensips
mkdir /var/run/opensips
useradd -d /var/run/opensips/ -s /bin/false -g opensips opensips
chown -R opensips.opensips /var/run/opensips

===Configurando o opensipsctl===
O opensipsctl (e opensipsdbctl) utilizam o arquivo de configuração /etc/opensips/opensipsctlrc, abaixo segue o conteúdo do arquivo. (Sugiro que você faça um backup dos arquivos originais para ter uma copia, existem parametros que você pode estudar depois).

<pre>
DBENGINE=MYSQL
DBHOST=localhost
DBNAME=opensips
DBRWUSER=opensips
DBRWPW="opensipsrw"
SIP_DOMAIN=10.254.254.6 ### caso voce esteja usando outro ip altere aqui

DBROOTUSER="root"
INSTALL_EXTRA_TABLES=ask
ALIASES_TYPE="DB"
MI_CONNECTOR=FIFO:/tmp/opensips_fifo
# VERIFY_ACL=1
# ACL_GROUPS="local ld int voicemail free-pstn"
# VERBOSE=1
# STORE_PLAINTEXT_PW=0
# NOHLPRINT=1
PID_FILE=/var/run/opensips/opensips.pid
</pre>

===Criando o banco de dados===
Agora que temos nosso arquivo configurado vamos fazer a criação do banco de dados, execute o comando abaixo.
<pre>
opensipsdbctl create opensips
</pre>

O sistema irá lhe perguntar algumas coisas, responda Y (sim) para todas para que ele instale todas as tabelas, não usaremos todas elas, mas desta forma você fica com praticamente tudo criado para o caso de uma expansão dos recursos.

===Instalando o RTP Proxy===
<pre>
cd /usr/src/
wget -c http://b2bua.org/chrome/site/rtpproxy-1.2.1.tar.gz
tar -xzvf rtpproxy-1.2.1.tar.gz
cd rtpproxy-1.2.1
./configure
make
make install
groupadd rtpproxy
useradd -d /var/run/rtpproxy -s /bin/true -g rtpproxy rtpproxy
mkdir /var/log/rtpproxy
mkdir /var/run/rtpproxy
chown -R rtpproxy.rtpproxy /var/log/rtpproxy
chown -R rtpproxy.rtpproxy /var/run/rtpproxy
</pre>

====Arquivo de inicialização====
'''/etc/init.d/rtpproxy'''
<pre>
#!/bin/bash
#
# Este script e de autoria de Mike Tesliuk
# qualquer falha no mesmo por favor informe
# atraves do email mike (a) tesliuk.com
#
### BEGIN INIT INFO
# Provides: rtpproxy
# Required-Start: $syslog $network $local_fs $time
# Required-Stop: $syslog $network $local_fs
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start the RTPPROXY server
# Description: Start the RTPPROXY server
### END INIT INFO

PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin
USELOG=1
USER=rtpproxy
# Altere o ip abaixo para o ip de seu sistema
IPADDR="10.254.254.6"

. /lib/lsb/init-functions

start(){
echo "Iniciando RTP PROXY "
if [ -z $(pidof rtpproxy) ]; then
if [ "${USELOG}" = "1" ]; then
echo "Iniciando com LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /var/log/rtpproxy/rtpproxy.log &
else
echo "Iniciando sem LOG"
/usr/local/bin/rtpproxy -l $IPADDR -s udp:127.0.0.1:7722 -u $USER -F -f d DBUG 2&> /dev/null
fi

if [ -n $(pidof rtpproxy) ]; then
echo "START OK"
fi
else
echo "Processo ja em execucao"
fi
}

stop(){

if [ -z $(pidof rtpproxy) ]; then
echo "Processo nao encontrado"
else
kill -9 $(pidof rtpproxy)
if [ -n $(pidof rtpproxy) ]; then
echo "STOP OK"
else
echo "Falha em realizar stop do servico"
fi

fi
}

case $1 in
start)
start
;;
stop)
stop
;;
restart)
stop
start

;;
*)
echo "Utilize: stop | start | restart"
;;
esac

</pre>

Vamos dar permissao e colocar na inicialização
chmod +x /etc/init.d/rtpproxy
update-rc.d rtpproxy defaults
/etc/init.d/rtpproxy start

===Criando o arquivo opensips.cfg===
O arquivo opensips.cfg é a onde a coisa toda acontece para o opensips, claro que ele dependerá de informações que estarão no banco de dados, mas é onde criamos todas as nossas rotas e validações.

<pre>
####### Global Parameters #########
debug=3
log_stderror=no
log_facility=LOG_LOCAL0

fork=yes
children=4

/* Descomente as linhas abaixo para ativar o debug */
#debug=7
#fork=no
#log_stderror=yes

/* Comente a linha abaixo para ativar a descoberta automatica de enderecos locais
, isso significa que o sistema ira verificar todos os ips ativos e hosts e entao ativara
o protocolo para todos eles */
auto_aliases=no

/* Defina aqui o ip a ser utilizado */
listen=udp:10.254.254.6:5060 # Altere este IP para o seu ambiente

/* Nao usaremos sip por tcp nem tls neste script */
disable_tcp=yes

disable_tls=yes

####### Secao de modulos ########

#set module path
mpath="/usr//lib64/opensips/modules/"

loadmodule "signaling.so"
loadmodule "sl.so"
loadmodule "tm.so"
modparam("tm", "fr_timer", 5)
modparam("tm", "fr_inv_timer", 30)
modparam("tm", "restart_fr_on_each_reply", 0)
modparam("tm", "onreply_avp_mode", 1)

loadmodule "rr.so"
/* do not append from tag to the RR (no need for this script) */
modparam("rr", "append_fromtag", 0)

loadmodule "maxfwd.so"
loadmodule "sipmsgops.so"
loadmodule "mi_fifo.so"
modparam("mi_fifo", "fifo_name", "/tmp/opensips_fifo")
modparam("mi_fifo", "fifo_mode", 0666)

loadmodule "db_mysql.so"

loadmodule "uri.so"
modparam("uri", "use_uri_table", 0)

loadmodule "usrloc.so"
modparam("usrloc", "nat_bflag", "FLB_NATB")
modparam("usrloc", "db_mode", 2)
modparam("usrloc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "registrar.so"
modparam("registrar", "tcp_persistent_flag", "TCP_PERSISTENT")

/* Descomente a linha abaixo para nao permitir mais de 10 contatos por conta */
#modparam("registrar", "max_contacts", 10)

loadmodule "acc.so"
/* Quais eventos deverao ser registrados ? */
modparam("acc", "early_media", 0)
modparam("acc", "report_cancels", 0)
/* por padrao nos nao ajustamos a direcao em requisicoes sequencias,
se voce deseja usar este recurso tenha certeza de ativar o "appen_fromtag"
para o modulo "rr" */
modparam("acc", "detect_direction", 0)
modparam("acc", "failed_transaction_flag", "FLT_ACCFAILED")
/* Gatilhos para accounting (flags) */
modparam("acc", "log_flag", "FLT_ACC")
modparam("acc", "log_missed_flag", "FLT_ACCMISSED")
modparam("acc", "log_extra",
"src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd")
modparam("acc", "db_flag", "FLT_ACC")
modparam("acc", "db_missed_flag", "FLT_ACCMISSED")
modparam("acc", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("acc", "db_extra", "src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd" )

loadmodule "auth.so"
loadmodule "auth_db.so"
modparam("auth_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("auth_db", "calculate_ha1", yes)
modparam("auth_db", "password_column", "password")
modparam("auth_db", "load_credentials", "")

loadmodule "permissions.so"
modparam("permissions", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "alias_db.so"
modparam("alias_db", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

loadmodule "presence.so"
modparam("presence", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

#loadmodule "presence_xml.so"

loadmodule "dialog.so"
modparam("dialog", "db_mode", 2)
modparam("dialog", "db_url","mysql://opensips:opensipsrw@localhost/opensips")
modparam("dialog", "dlg_match_mode", 1)
#modparam("dialog", "default_timeout", 60)

loadmodule "siptrace.so"
modparam("siptrace", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("siptrace", "trace_flag", 22)
modparam("siptrace", "traced_user_avp", "$avp(s:traceuser)")

loadmodule "nathelper.so"
modparam("nathelper", "natping_interval", 30)
modparam("nathelper", "ping_nated_only", 1)
modparam("nathelper", "sipping_bflag", "FLB_NATSIPPING")
modparam("nathelper", "sipping_from", "sip:pinger@10.254.254.6") # Altere o ip para o ip do servidor
modparam("nathelper|registrar", "received_avp", "$avp(RECEIVED)")

loadmodule "rtpproxy.so"
modparam("rtpproxy", "rtpproxy_sock", "udp:127.0.0.1:7722")

####### Logica de roteamento ########

route {

if (!mf_process_maxfwd_header("3")) {
send_reply("483","looping");
exit;
}

xlog("REQUISICAO RECEBIDA, ENVIANDO PARA REQINIT");
# Checagem inicial por requisicao
route(REQINIT);

xlog("ENVIANDO PARA NAT");
# Deteccao de nat
route(NAT);

xlog("ENVIANDO PARA WITHINDLG");
# Gerenciando requisicaoes com dialog
route(WITHINDLG);

# Manipulando requisicoes iniciais (nao consta To tag)

# Processando CANCEL

if(is_method("CANCEL")){
xlog("METHOD CANCEL");
if(t_check_trans()){
t_relay();
}
exit;
}

t_check_trans();

# Enviando para autenticacao
xlog("ENVIANDO PARA AUTENTICACAO");
route(AUTH);

# gravando rota para formacao dos dialogs (caso sejam roteados)
# removemos qualquer cabecalho de rota pre carregado
remove_hf("Route");
if(is_method("INVITE|SUBSCRIBE")){
xlog("METHOD INVITE OU SIBSCRIBE");
record_route();
}

# Contabilizando (acc) INVITES
if(is_method("INVITE")){
xlog("METHOD INVITE, FAZENDOA ACC");
setflag(FLT_ACC);
}

# Enviando chamada para destinos externos
xlog("ENVIANDO PARA SIPOUT");
route(SIPOUT);

# Requisicoes para dominio local

# Roteando requisicoes de PRESENCE
xlog("ENVIANDO PARA PRESENCE");

route(PRESENCE);

# Gerenciando pedidos de registro
xlog("ENVIANDO PARA REGISTRAR");
route(REGISTRAR);

if($ru==""){
xlog("ru --> vazio");
# Requisicao sem usuario na RURI
sl_send_reply("484", "Address Incomplete");
}

# Enviando requisicao para PSTN
xlog("ENVIANDO PARA PSTN");
route(PSTN);

# Salvando informacao de quem originou a chamad
$avp(callee)=$rU;
xlog("ENVIANDO PARA DISPATCH PSTN");
route(FSDISPATCH);

# Servico de localizacao de usuario
route(LOCATION);

# Efetuando o relay (encaminhamento)
route(RELAY);

}

route[RELAY] {
if(check_route_param("nat=yes")){
setbflag(FLB_NATB);
}

if(isflagset(FLT_NATS) || isbflagset(FLB_NATB)){
#route(RTPPROXY);
}

# if(is_method("INVITE")){
# t_on_reply("REPLY_ONE");
# t_on_failure("FAIL_ONE");
# }

xlog("AQUI TENTAMOS ENVIAR A CHAMADA $fU $tU");
if(!t_relay()){
xlog("FALHA EM ENVIAR A CHAMADA, NAO FOI POSSIVEL FAZER O RELAY");
sl_reply_error();
}
xlog("CHAMADA FOI ENVIADA AQUI, QUAL O ERRO ENTAO");

exit;
}

route[REQINIT] {
if(!mf_process_maxfwd_header("10")){
sl_send_reply("483", "Too Many Hops");
exit;
}

}

route[WITHINDLG] {
if(has_totag()){
if(loose_route()){
if(is_method("BYE")){
setflag(FLT_ACC);
setflag(FLT_ACCFAILED);
}
route(RELAY);
}else{
if(is_method("SUBSCRIBE") && uri==myself) {
# requisicao de subscribe pre-estabelecida
route(PRESENCE);
exit;
}

if(is_method("ACK")){
if(t_check_trans()){
t_relay();
exit;
}
}else{
# ACK para transacao nao encontrada, ignoramos...
exit;

}

sl_send_reply("404", "Not Here");

}
exit;
}
}

route[REGISTRAR] {

if(is_method("REGISTER")){
if(isflagset(FLT_NATS)){
setbflag(FLB_NATB);
}

if(!save("location")){
sl_reply_error();
}

exit;
}

}

route[LOCATION] {

alias_db_lookup("dbaliases");
if(!lookup("location")){
switch($rc) {
case -1:
case -3:
t_newtran();
t_reply("404","Not Found");
exit;
case -2:
sl_send_reply("405", "Method Not Allowed");
exit;
}
}

if(is_method("INVITE")){
setflag(FLT_ACCMISSED);
}

}

route[PRESENCE] {
if(!is_method("PUBLISH|SUBSCRIBE")){
return;
}

if(!t_newtran()){
sl_reply_error();
exit;
}

if(is_method("PUBLISH")){
handle_publish();
}else if(is_method("SUBSCRIBE")){
handle_subscribe();
}
exit;

}

route[AUTH]{
xlog("PEDIDO DE AUTENTICACAO");
if(is_method("REGISTER")){
# atentica pedidos de registro
if(!www_authorize("", "subscriber")){
www_challenge("", "0");
exit;
}

if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if(route(FSINBOUND)){
return;
}

if(check_source_address("0")){
return;
}

if(from_uri==myself){
if(!proxy_authorize("", "subscriber")){
proxy_challenge("","0");
exit;
}

if(is_method("PUBLISH")){
if($au!=$tU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}

}else{
if($au!=$fU){
sl_send_reply("403", "Forbidden auth ID");
exit;
}
}

# Validamos (autenticamos) o usuario
consume_credentials();
}else{

# usuario nao e local, vamos negar
if(!uri==myself){
sl_send_reply("403", "Not relaying");
exit;
}
}
}

return;
}

route[NAT] {
force_rport();
if(nat_uac_test("19")){
if(method=="REGISTER"){
fix_nated_register();
}else{
fix_nated_contact();
}
setflag(FLT_NATS);
}

return;
}

route[RTPPROXY] {
if(is_method("BYE")){
unforce_rtp_proxy();
}else if(is_method("INVITE")){
engage_rtp_proxy();
}

if(!has_totag()){

if(!check_route_param("nat=yes")){
add_rr_param(";nat=yes");
xlog("NAT yes NAO ENCONTRADO");
}
}

return;
}

route[SIPOUT]{
if(!uri==myself){
append_hf("P-hint: outbound\r\n");
route(RELAY);
}
}

route[PSTN]{
# neste caso apenas para exemplificar um uso simples
# vamos fazer o redirecionamento par ao asterisk
# realizar a dicagem da chamada

if(!($rU=~"^(\+|00)[1-9][0-9]{3,20}$"))
return;

## a regra acima aceita para discagem externa qualquer numero
# comecado com 00 ou +
#

if(from_uri!=myself){
sl_send_reply("403", "Not Allowed");
exit;
}

$ru = "sip:" + $rU + "@" + "10.254.254.6:5090";
xlog("NOVO DESTINO: $ru");
route(RELAY);
exit;

}

route[XMLRPC]{
# nao vamos implementar esta funcionalidade
return;
}

route[FSINBOUND] {
# verificar para validar o ip do asterisk:porta
# se bater , responder com return 1;
if($si=="10.254.254.6" && $sp=="5090"){
return(1);
}else{
return(-1);
}
}

route[FSDISPATCH] {

if(!is_method("INVITE")){
return;
}

if(route(FSINBOUND)){
return;
}

xlog("CAIMOS NO SWITCH, VAMOS LOCALIZAR O PERFIL DA CHAMADA $rU");

if($rU =~ "^41$"){
xlog("SWITCH expressa comeca e termina em 41");
#regra de menu de voicemail, apenas
# usuarios autenticados
if($au==""){
sl_send_reply("403", "Not Allowed");
exit;
}

$rU = "vma-" + $au;
}else if($rU =~ "^441[0-9][0-9]$"){
xlog("SWTICH OPCA 441XX ");
# numero discado comeca com 441 seguido de dois digitos
# chamada direta para inbox do voicemail
strip(2);
route(FSVBOX);
}else if($rU =~ "^433[01][0-9][0-9]$"){
xlog("SWITCH OPCAO 433[01]XX");
# numero comecado em 443, seguido de 0 ou 1, mais dois digitos
# sistema de conferencia
strip(2);
}else if($rU =~ "^45[0-9]+$"){
xlog("SWTICH OPCAO 45X.");
#numero comecado com 45, seguindo de numeros;
strip(2);
}else{
xlog("OPCAO DEFAULT DO SWITCH");
# usuario offline, enviando para voicemail
if(!registered("location")){
route(FSVBOX);
exit;
}

# usuario online, fazendo bridging
xlog("USUARIO ESTA ONLINE VAMOS FAZER BRIDGE");
prefix("kb-");
if(is_method("INVITE")){
t_on_failure("FAIL_FSVBOX");
}
}
route(FSRELAY);
exit;
}

route[FSVBOX]{
xlog("ENVIANDO PARA FSVBOX");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($rU =~ "^441[0-9][0-9]"){
strip(2);
}
prefix("vm-");
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;
}

route[FSRELAY] {
xlog("ENVIANDO PARA FSRELAY");
$du = "sip:" + "10.254.254.6" + ":" + "5090";
if($var(newbranch)==1){
append_branch();
$var(newbranch)=0;
}
route(RELAY);
exit;

}

branch_route[BRANCH_ONE]{
xlog("new branch at $ru");
}

onreply_route[REPLY_ONE]{
xlog("Incoming reply");
if((isflagset(FLT_NATS) || isbflagset(FLB_NATB) && status =~ "(183)|(2[0-9][0-9])")){
#rtpproxy_offer();

}
if(isbflagset(FLB_NATB)){
fix_nated_contact();
}

}

failure_route[FAIL_ONE]{
xlog("FAILURE ROUTE FAIL_ONE");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

}

failure_route[FAIL_FSVBOX]{
xlog("FAILURE ROUTE FAIL_FSVBOX");
if(is_method("INVITE") && (isbflagset(FLB_NATB) || isflagset(FLT_NATS))){
unforce_rtp_proxy();
}

if(t_was_cancelled()){
exit;
}

if(t_check_status("486|408|480")){
$rU = $avp(callee);
$var(newbranch) = 1;
route(FSVBOX);
}
}

</pre>

==Testes com Opensips (registro)==

Antes de podermos testar precisamos iniciar o serviço, no momento estamos com ele operando em modo debug, então a inicialização deve ser realizada com o comando abaixo
/etc/init.d/opensips debug

Abra uma nova sessão no servidor e então vamos criar os usuários
opensipsctl add 101 101
opensipsctl add 102 102
opensipsctl add 103 103

usuario 101 com senha 101 e assim por diante

Faça a onexão com seu softphone, aqui para testes utilizei o jitsi e o zoiper, neste momento vamos apenas fazer o registro do usuário para testar a autenticação, se você tentar realizar uma discagem não funcionará pois neste caso o processo depende do Asterisk que ainda não está configurado, vamos dar inicio nesta configuração agora.

==Asterisk==
Não vamos dar muitos detalhes da instalação do asterisk aqui, a ideia é simplesmente ter o mesmo funcionando da forma que necessitamos.
apt-get install asterisk

Após a instalação , abra o arquivo /etc/asterisk/sip.conf, localize a linha '''udpbindaddr=0.0.0.0''' e altere para '''udpbindaddr=0.0.0.0:5090''' , depois ao fim do arquivo adicione.
<pre>
[opensips]
type=peer
host=10.254.254.6
port=5060
qualify=yes
context=opensips
insecure=port,invite
canreinvite=no
</pre>

Agora abra o arquivo '''/etc/asterisk/extensions.conf''' , crie no fim do arquivo a seguinte entrada.
<pre>
[opensips]

exten => _kb-1XX,1,NoOp(CHAMADA INTERNA - FAZER BRIDGE - ${CALLERID(num)} ${EXTEN:3})
same => n,Dial(SIP/opensips/${EXTEN:3})
same => n,Goto(opensips,vm-${EXTEN:3},1)
same => n,Hangup()

exten => _vm-1XX,1,NoOp(CHAMADA PARA VOICEMAIL)
same => n,Voicemail(${EXTEN:3}@default)
same => n,Hangup()

exten => _vma-1XX,1,NoOp(CHAMADA PARA VOICEMAIL - ADMINISTRATIVO)
same => n,VoicemailMain(${EXTEN:4}@default)
same => n,Hangup()

exten => _3[01]XX,1,NoOp(CHAMADA PARA CONFERENCIA)
same => n,Answer()
same => n,ConfBridge(${EXTEN},cM1)
same => n,Hangup()

exten => _00.,1,NoOp(CHAMADA PARA PSTN)
same => n,Wait(2)
same => n,Answer()
same => n,Wait(1)
same => n,PlayBack(tt-monkeys)
same => n,Hangup()

exten => h,1,Hangup()

</pre>

Finalmente precisamos criar as entradas do voicemail, para isso altere o arquivo '''/etc/asterisk/voicemail.conf''' localize o contexto '''[default]''' e então adicione as entradas para seu voicemail, segue dois exemplos abaixo.
<pre>
101 => 123123,Mike Tesliuk
102 => 123123,Mike Tesliuk 2
</pre>

Feito isso, faça um restart no asterisk
/etc/init.d/asterisk restart

Agora você ja poderá fazer os testes, basicamente criamos as seguintes situações para serem testadas.

*1 Autenticação de usuários
*2 Chamada entre usuários
*3 Encaminhamento para caixa postal
*4 Acesso a caixa postal
*5 Acesso a conferência

MediaWiki:Sidebar

2021-04-15T22:49:36Z

Admin:

Página principal

2013-08-12T00:03:31Z

Admin:

Bem vindo ao wiki da comunidade OpenSIPs Brasil

Este wiki tem como objetivo ser uma ferramenta para centralização de documentações sobre OpenSIPs preferencialmente em lingua portuguesa, obviamente algumas documentações temos certeza que merecerão uma tradução para outra lingua para garantir a disseminação do conhecimento aqui gerado.

Se você tem interesse em participar, acesse nosso site http://www.opensips.com.br/wp/ e veja como, participe da comunidade, gere documentações, vamos tornar acessivel este conhecimento.

No momento a criação de usuários está desativada para prevenção de SPAM (muito comum em wiki's), desta forma se você deseja contribuir com o wiki por favor entre em contato conosco através da lista de email solicitando a criação de um usuário.

Traducoes-opensips

2013-08-12T00:02:27Z

Admin:

Esta área é reservada para criação de traduções de documentos existentes no site opensips.org , este é um trabalho lento pois demanda tempo e temos que fazer isso no decorrer de nossas horas livres, desta forma, todo mundo que quiser contribuir será bem vindo.

==[[OpenSIPS 1.9 Manual]]==

Teste

2013-08-01T18:47:51Z

Admin:

Arquivos de configuração

2013-08-01T18:37:14Z

Admin:

O arquivo de configuração do OpenSIPS contém todos os parâmetros que controlam o núcleo e os módulos do OpenSIPS, juntamente com a lógica de roteamento que OpenSIPS usará para rotear o tráfego SIP.

Após a instalação, o local do arquivo de configuração padrão é:

<pre>
INSTALL_PATH/etc/opensips/opensips.cfg
</pre>

O arquivo de configuração é baseado em texto, escrita em uma linguagem personalizada para o OpenSISP, muito similar a linguagem C. Você irá encontra variáveis diferentes ( cada uma com diferentes escopos - explicado mais abaixo neste manual ), você pode fazer construções clássicas como if / while / switch, etc, e você pode também chamar sub-rotinas com parâmetros, então o script deverá ser facilmente legível para qualquer um com habilidades em programação SIP.

Devido ao fato de ter que reiniciar o OpenSIPS a cada mudança no arquivo de configuração, isto é de vital importância garantir que tudas as mudanças tenham efeito de acordo com a sintaxe de linguagem do OpenSIPS.

Você pode verificar a validade do arquivo de configuração do OpenSIPS executando o seguinte comando:

<pre>
[INSTALL_PATH]/sbin/opensips -C [PATH_TO_CFG]
</pre>

Ao verificar o arquivo de configuração através do validador, se o cfg estiver OK, o OpenSIPS irá retornar 0.

Se a configuração conter algum erro, eles serão apresentados no console e o OpenSIPS irá retornar -1.

Arquivos de configuração

2013-08-01T18:36:50Z

Admin:

O arquivo de configuração do OpenSIPS contém todos os parâmetros que controlam o núcleo e os módulos do OpenSIPS, juntamente com a lógica de roteamento que OpenSIPS usará para rotear o tráfego SIP.

Após a instalação, o local do arquivo de configuração padrão é:

<pre>
INSTALL_PATH/etc/opensips/opensips.cfg
</pre>

O arquivo de configuração é baseado em texto, escrita em uma linguagem personalizada para o OpenSISP, muito similar a linguagem C. Você irá encontra variáveis diferentes ( cada uma com diferentes escopos - explicado mais abaixo neste manual ), você pode fazer construções clássicas como if / while / switch, etc, e você pode também chamar sub-rotinas com parâmetros, então o script deverá ser facilmente legível para qualquer um com habilidades em programação SIP.

{{ambox | text = Some text.}}

Devido ao fato de ter que reiniciar o OpenSIPS a cada mudança no arquivo de configuração, isto é de vital importância garantir que tudas as mudanças tenham efeito de acordo com a sintaxe de linguagem do OpenSIPS.

Você pode verificar a validade do arquivo de configuração do OpenSIPS executando o seguinte comando:

<pre>
[INSTALL_PATH]/sbin/opensips -C [PATH_TO_CFG]
</pre>

Ao verificar o arquivo de configuração através do validador, se o cfg estiver OK, o OpenSIPS irá retornar 0.

Se a configuração conter algum erro, eles serão apresentados no console e o OpenSIPS irá retornar -1.

Teste

2013-08-01T18:33:48Z

Admin:

Módulo:HtmlBuilder

2013-08-01T18:33:23Z

Admin: uma edição

-- Experimental module for building complex HTML (e.g. infoboxes, navboxes) using a fluent interface

local HtmlBuilder = {}

local metatable = {}

metatable.__index = function(t, key)
local ret = rawget(t, key)
if ret then
return ret
end

ret = metatable[key]
if type(ret) == 'function' then
return function(...)
return ret(t, ...)
end
else
return ret
end
end

metatable.__tostring = function(t)
local ret = {}
t._build(ret)
return table.concat(ret, '')
end

metatable._build = function(t, ret)
if t.tagName then
table.insert(ret, '<' .. t.tagName)
for i, attr in ipairs(t.attributes) do
table.insert(ret, ' ' .. attr.name .. '="' .. attr.val .. '"')
end
if #t.styles > 0 then
table.insert(ret, ' style="')
for i, prop in ipairs(t.styles) do
if type(prop) == 'string' then -- added with cssText()
table.insert(ret, prop .. ';')
else -- added with css()
table.insert(ret, prop.name .. ':' .. prop.val .. ';')
end
end
table.insert(ret, '"')
end
if t.selfClosing then
table.insert(ret, ' /')
end
table.insert(ret, '>')
end
for i, node in ipairs(t.nodes) do
if node then
if type(node) == 'table' then
node._build(ret)
else
table.insert(ret, tostring(node))
end
end
end
if t.tagName and not t.unclosed and not t.selfClosing then
table.insert(ret, '</' .. t.tagName .. '>')
end
end

metatable.node = function(t, builder)
if builder then
table.insert(t.nodes, builder)
end
return t
end

metatable.wikitext = function(t, ...)
local vals = {...}
for i = 1, #vals do
if vals[i] then
table.insert(t.nodes, vals[i])
end
end
return t
end

metatable.newline = function(t)
table.insert(t.nodes, '\n')
return t
end

metatable.tag = function(t, tagName, args)
args = args or {}
args.parent = t
local builder = HtmlBuilder.create(tagName, args)
table.insert(t.nodes, builder)
return builder
end

function getAttr(t, name)
for i, attr in ipairs(t.attributes) do
if attr.name == name then
return attr
end
end
end

metatable.attr = function(t, name, val)
-- if caller sets the style attribute explicitly, then replace all styles previously added with css() and cssText()
if name == 'style' then
t.styles = {val}
return t
end

local attr = getAttr(t, name)
if attr then
attr.val = val
else
table.insert(t.attributes, {name = name, val = val})
end

return t
end

metatable.addClass = function(t, class)
if class then
local attr = getAttr(t, 'class')
if attr then
attr.val = attr.val .. ' ' .. class
else
t.attr('class', class)
end
end

return t
end

metatable.css = function(t, name, val)
if type(val) == 'string' or type(val) == 'number' then
for i, prop in ipairs(t.styles) do
if prop.name == name then
prop.val = val
return t
end
end

table.insert(t.styles, {name = name, val = val})
end

return t
end

metatable.cssText = function(t, css)
if css then
table.insert(t.styles, css)
end
return t
end

metatable.done = function(t)
return t.parent or t
end

metatable.allDone = function(t)
while t.parent do
t = t.parent
end
return t
end

function HtmlBuilder.create(tagName, args)
args = args or {}
local builder = {}
setmetatable(builder, metatable)
builder.nodes = {}
builder.attributes = {}
builder.styles = {}
builder.tagName = tagName
builder.parent = args.parent
builder.unclosed = args.unclosed or false
builder.selfClosing = args.selfClosing or false
return builder
end

return HtmlBuilder

Módulo:Namespace detect

2013-08-01T18:33:23Z

Admin: uma edição

----------------------------------------------------------------------
-- --
-- NAMESPACE DETECT --
-- --
-- This module implements the {{namespace detect}} template --
-- in Lua, with a few improvements: all namespaces and all --
-- namespace aliases are supported, and namespace names are --
-- detected automatically for the local wiki. Function names --
-- can be configured for different wikis by altering the --
-- values in the "cfg" table. --
-- --
----------------------------------------------------------------------

----------------------------------------------------------------------
-- Configuration data --
-- Language-specific parameter names can be set here. --
----------------------------------------------------------------------

local cfg = {}

-- The name for the parameter to display content for the main namespace:
cfg.main = 'main'

-- The name for the parameter to display content in talk namespaces:
cfg.talk = 'talk'

-- The name for the parameter to display content for "other" namespaces
-- (namespaces for which parameters have not been specified, or for when
-- cfg.demospace is set to cfg.other):
cfg.other = 'other'

-- The name for the parameter to set a demonstration namespace:
cfg.demospace = 'demospace'

-- The name for the parameter to set a specific page to compare:
cfg.page = 'page'

-- The header for the namespace column in the wikitable containing the
-- list of possible subject-space parameters.
cfg.wikitableNamespaceHeader = 'Namespace'

-- The header for the wikitable containing the list of possible
-- subject-space parameters.
cfg.wikitableAliasesHeader = 'Aliases'

----------------------------------------------------------------------
-- End configuration data --
----------------------------------------------------------------------

----------------------------------------------------------------------
-- Global functions --
-- The following functions are global, because we want them --
-- to be accessible from other Lua modules called using --
-- require(). --
----------------------------------------------------------------------

-- Declare the table of functions to return.
local p = {}

-- Get the page object. This will return the page object for the page
-- specified, or nil if there are errors in the title or if the
-- expensive function count has been exceeded.
function p.getPageObject( page )
-- Get the title object for args.page if it is specified. Otherwise
-- get the title object for the current page.
if page then
-- Get the page object, passing the function through pcall
-- in case we are over the expensive function count limit.
local noError, pageObject = pcall(mw.title.new, page)
if not noError then
return nil
else
return pageObject
end
else
return mw.title.getCurrentTitle()
end
end

--[[ Returns a table of how parameter names map to namespace names.
The keys are the actual namespace names, in lower case, and the
values are the possible parameter names for that namespace, also
in lower case. The table entries are structured like this:
[''] = {
{'main'},
},
['wikipedia'] = {
{'wikipedia', 'project', 'wp' }
}
]]
function p.getParamMappings()
local mappings = {}
mappings[mw.ustring.lower( mw.site.namespaces[0].name )] = { cfg.main }
mappings[cfg.talk] = { cfg.talk }
for nsid, ns in pairs( mw.site.subjectNamespaces ) do
if nsid ~= 0 then -- Exclude main namespace.
local nsname = mw.ustring.lower( ns.name )
local canonicalName = mw.ustring.lower( ns.canonicalName )
mappings[nsname] = { nsname }
if canonicalName ~= nsname then
table.insert( mappings[nsname], canonicalName )
end
for _, alias in ipairs( ns.aliases ) do
table.insert( mappings[nsname], mw.ustring.lower( alias ) )
end
end
end
return mappings
end

--[[ Create a wikitable of all subject namespace parameters, for documentation
purposes. Talk is excluded, as it should usually be treated separately in
the documentation.
]]
function p.table()
-- Get the parameter mappings.
local mappings = p.getParamMappings()

-- Start the wikitable.
local ret = '{| class="wikitable"'
.. '\n|-'
.. '\n! ' .. cfg.wikitableNamespaceHeader
.. '\n! ' .. cfg.wikitableAliasesHeader

-- Generate the row for the main namespace, as we want this
-- to be first in the list.
ret = ret .. '\n|-'
.. '\n| <code>' .. cfg.main .. '</code>'
.. '\n|'

-- Enclose all parameter names in <code> tags.
for ns, params in pairs( mappings ) do
if ns ~= mw.site.namespaces[0].name then
for i, param in ipairs( params ) do
mappings[ns][i] = '<code>' .. param .. '</code>'
end
end
end

-- Generate the other wikitable rows.
for ns, params in pairs( mappings ) do
if ns ~= mw.site.namespaces[0].name then -- Ignore the main namespace.
ret = ret .. '\n|-'
.. '\n| ' .. params[1]
.. '\n| ' .. table.concat( params, ', ', 2 )
end
end

-- End the wikitable.
ret = ret .. '\n|-'
.. '\n|}'

return ret
end

----------------------------------------------------------------------
-- Local functions --
-- The following are internal functions, which we do not want --
-- to be accessible from other modules. --
----------------------------------------------------------------------

-- Gets the namespace name to compare to the arguments. The returned value
-- is lower-case.
local function getNamespace( page, demospace )
local ret
if demospace then
-- Handle "demospace = main" properly.
if mw.ustring.lower( demospace ) == cfg.main then
ret = mw.site.namespaces[0].name
else
ret = demospace
end
else
local pageObject = p.getPageObject( page )
if pageObject then
if pageObject.isTalkPage then
-- {{namespace detect}} uses the same value for all talk
-- namespaces, so that's what the module should do too.
ret = cfg.talk
else
ret = pageObject.nsText
end
else
return nil -- return nil if the page object doesn't exist.
end
end
return mw.ustring.lower(ret)
end

-- Compare the namespace found with the parameters that have been
-- specified, and return content of the appropriate parameter.
local function compare( args )
-- Get the namespace to compare the parameters to, and the parameter
-- mapping table.
local namespace = getNamespace( args[cfg.page], args[cfg.demospace] )
local mappings = p.getParamMappings()

-- Check for any matches in the namespace arguments. The order we check
-- them doesn't matter, as there can only be one match.
for ns, params in pairs( mappings ) do
if ns == namespace then
-- Check all aliases for matches. The default local namespace is
-- checked first, as {{namespace detect}} checked these before
-- alias names.
for _, param in ipairs( params ) do
if args[param] then
return args[param]
end
end
end
end

-- If there were no matches, return parameters for other namespaces.
-- This happens if there was no text specified for the namespace that
-- was detected or if the demospace parameter is not a valid namespace.
-- Note that the parameter for the detected namespace must be completely
-- absent for this to happen, not merely blank.
if args[cfg.other] then
return args[cfg.other]
end
end

----------------------------------------------------------------------
-- Main function --
-- This is the function that will be most used. It processes --
-- the arguments and calls the compare() function. It is --
-- global, but is put down here as it depends on the other --
-- local in order for it to work. --
----------------------------------------------------------------------

function p.main(frame)
-- If called via #invoke, use the args passed into the invoking
-- template, or the args passed to #invoke if any exist. Otherwise
-- assume args are being passed directly in.
local origArgs
if frame == mw.getCurrentFrame() then
origArgs = frame:getParent().args
for k, v in pairs( frame.args ) do
origArgs = frame.args
break
end
else
origArgs = frame
end

-- Trim whitespace and remove blank arguments for demospace and
-- page parameters.
local args = {}
for k, v in pairs(origArgs) do
v = mw.text.trim(v) -- Trim whitespace.
if k == cfg.demospace or k == cfg.page then
if v ~= '' then
args[k] = v
end
else
args[k] = v
end
end

return compare(args)
end

return p

Módulo:Navbar

2013-08-01T18:33:23Z

Admin: uma edição

local p = {}

local HtmlBuilder = require('Module:HtmlBuilder')

function trim(s)
return mw.ustring.match( s, "^%s*(.-)%s*$" )
end

function error(s)
local span = HtmlBuilder.create('span')

span
.addClass('error')
.css('float', 'left')
.css('white-space', 'nowrap')
.wikitext('Error: ' .. s)

return tostring(span)
end

function getTitle( pageName )
pageName = trim( pageName );
local page_title, talk_page_title;

if mw.ustring.sub(pageName, 1, 1) == ':' then
page_title = mw.title.new( mw.ustring.sub(pageName, 2) );
else
page_title = mw.title.new( pageName, 'Template' );
end

if page_title then
talk_page_title = page_title.talkPageTitle;
else
talk_page_title = nil;
end

return page_title, talk_page_title;
end

function _navbar( args )
if not args[1] then
return error('No name provided')
end

local good, title, talk_title;
good, title, talk_title = pcall( getTitle, args[1] );
if not good then
return error('Expensive parser function limit exceeded');
end

if not title then
return error('Page does not exist')
end

local mainpage = title.fullText;
local talkpage = talk_title and talk_title.fullText or ''
local editurl = title:fullUrl( 'action=edit' );

local viewLink, talkLink, editLink = 'view', 'talk', 'edit'
if args.mini then
viewLink, talkLink, editLink = 'v', 't', 'e'
end

local div = HtmlBuilder.create( 'div' )
div
.addClass( 'noprint' )
.addClass( 'plainlinks' )
.addClass( 'hlist' )
.addClass( 'navbar')
.cssText( args.style )

if args.mini then div.addClass('mini') end

if not (args.mini or args.plain) then
div
.tag( 'span' )
.css( 'word-spacing', 0 )
.cssText( args.fontstyle )
.wikitext( args.text or 'This box:' )
.wikitext( ' ' )
end

if args.brackets then
div
.tag('span')
.css('margin-right', '-0.125em')
.cssText( args.fontstyle )
.wikitext( '[' )
.newline();
end

local ul = div.tag('ul');

ul
.tag( 'li' )
.addClass( 'nv-view' )
.wikitext( '[[' .. mainpage .. '|' )
.tag( 'span ' )
.attr( 'title', 'View this template' )
.cssText( args.fontstyle or '' )
.wikitext( viewLink )
.done()
.wikitext( ']]' )
.done()
.tag( 'li' )
.addClass( 'nv-talk' )
.wikitext( '[[' .. talkpage .. '|' )
.tag( 'span ' )
.attr( 'title', 'Discuss this template' )
.cssText( args.fontstyle or '' )
.wikitext( talkLink )
.done()
.wikitext( ']]' );

if not args.noedit then
ul
.tag( 'li' )
.addClass( 'nv-edit' )
.wikitext( '[' .. editurl .. ' ' )
.tag( 'span ' )
.attr( 'title', 'Edit this template' )
.cssText( args.fontstyle or '' )
.wikitext( editLink )
.done()
.wikitext( ']' );
end

if args.brackets then
div
.tag('span')
.css('margin-left', '-0.125em')
.cssText( args.fontstyle or '' )
.wikitext( ']' )
.newline();
end

return tostring(div)
end

function p.navbar(frame)
local origArgs
-- If called via #invoke, use the args passed into the invoking template.
-- Otherwise, for testing purposes, assume args are being passed directly in.
if frame == mw.getCurrentFrame() then
origArgs = frame:getParent().args
else
origArgs = frame
end

-- ParserFunctions considers the empty string to be false, so to preserve the previous
-- behavior of {{navbar}}, change any empty arguments to nil, so Lua will consider
-- them false too.
args = {}
for k, v in pairs(origArgs) do
if v ~= '' then
args[k] = v
end
end

return _navbar(args)
end

return p

Módulo:Navbox

2013-08-01T18:33:23Z

Admin: uma edição

--
-- This module will implement {{Navbox}}
--

local p = {}

local HtmlBuilder = require('Module:HtmlBuilder')
local Navbar = require('Module:Navbar')

local args
local frame
local tableRowAdded = false
local border
local listnums = {}

function trim(s)
return (mw.ustring.gsub(s, "^%s*(.-)%s*$", "%1"))
end

function addTableRow(tbl)
-- If any other rows have already been added, then we add a 2px gutter row.
if tableRowAdded then
tbl
.tag('tr')
.css('height', '2px')
.tag('td')
end

tableRowAdded = true

return tbl.tag('tr')
end

--
-- Title row
--
function renderTitleRow(tbl)
if not args.title then return end

local titleRow = addTableRow(tbl)

if args.titlegroup then
titleRow
.tag('th')
.attr('scope', 'row')
.addClass('navbox-group')
.addClass(args.titlegroupclass)
.cssText(args.basestyle)
.cssText(args.groupstyle)
.cssText(args.titlegroupstyle)
.wikitext(args.titlegroup)
end

local titleCell = titleRow.tag('th').attr('scope', 'col')

if args.titlegroup then
titleCell
.css('border-left', '2px solid #fdfdfd')
.css('width', '100%')
end

local titleColspan = 2
if args.imageleft then titleColspan = titleColspan + 1 end
if args.image then titleColspan = titleColspan + 1 end
if args.titlegroup then titleColspan = titleColspan - 1 end

titleCell
.cssText(args.basestyle)
.cssText(args.titlestyle)
.addClass('navbox-title')
.attr('colspan', titleColspan)

renderNavBar(titleCell)

titleCell
.tag('div')
.addClass(args.titleclass)
.css('font-size', '110%')
.newline()
.wikitext(args.title)
end

function renderNavBar(titleCell)
-- Depending on the presence of the navbar and/or show/hide link, we may need to add a spacer div on the left
-- or right to keep the title centered.
local spacerSide = nil

if args.navbar == 'off' then
-- No navbar, and client wants no spacer, i.e. wants the title to be shifted to the left. If there's
-- also no show/hide link, then we need a spacer on the right to achieve the left shift.
if args.state == 'plain' then spacerSide = 'right' end
elseif args.navbar == 'plain' or args.navbar == 'off' or (not args.name and (border == 'subgroup' or border == 'child' or border == 'none')) then
-- No navbar. Need a spacer on the left to balance out the width of the show/hide link.
if args.state ~= 'plain' then spacerSide = 'left' end
else
-- Will render navbar (or error message). If there's no show/hide link, need a spacer on the right
-- to balance out the width of the navbar.
if args.state == 'plain' then spacerSide = 'right' end

titleCell.wikitext(Navbar.navbar({
args.name,
mini = 1,
fontstyle = (args.basestyle or '') .. ';' .. (args.titlestyle or '') .. ';background:none transparent;border:none;'
}))
end

-- Render the spacer div.
if spacerSide then
titleCell
.tag('span')
.css('float', spacerSide)
.css('width', '6em')
.wikitext(' ')
end
end

--
-- Above/Below rows
--
function renderAboveRow(tbl)
if not args.above then return end

addTableRow(tbl)
.tag('td')
.addClass('navbox-abovebelow')
.addClass(args.aboveclass)
.cssText(args.basestyle)
.cssText(args.abovestyle)
.attr('colspan', getAboveBelowColspan())
.tag('div')
.newline()
.wikitext(args.above)
end

function renderBelowRow(tbl)
if not args.below then return end

addTableRow(tbl)
.tag('td')
.addClass('navbox-abovebelow')
.addClass(args.belowclass)
.cssText(args.basestyle)
.cssText(args.belowstyle)
.attr('colspan', getAboveBelowColspan())
.tag('div')
.newline()
.wikitext(args.below)
end

function getAboveBelowColspan()
local ret = 2
if args.imageleft then ret = ret + 1 end
if args.image then ret = ret + 1 end
return ret
end

--
-- List rows
--
function renderListRow(tbl, listnum)
local row = addTableRow(tbl)

if listnum == 1 and args.imageleft then
row
.tag('td')
.addClass('navbox-image')
.addClass(args.imageclass)
.css('width', '0%')
.css('padding', '0px 2px 0px 0px')
.cssText(args.imageleftstyle)
.attr('rowspan', 2 * #listnums - 1)
.tag('div')
.newline()
.wikitext(args.imageleft)
end

if args['group' .. listnum] then
local groupCell = row.tag('th')

groupCell
.attr('scope', 'row')
.addClass('navbox-group')
.addClass(args.groupclass)
.cssText(args.basestyle)

if args.groupwidth then
groupCell.css('width', args.groupwidth)
end

groupCell
.cssText(args.groupstyle)
.cssText(args['group' .. listnum .. 'style'])
.wikitext(args['group' .. listnum])
end

local listCell = row.tag('td')

if args['group' .. listnum] then
listCell
.css('text-align', 'left')
.css('border-left-width', '2px')
.css('border-left-style', 'solid')
else
listCell.attr('colspan', 2)
end

if not args.groupwidth then
listCell.css('width', '100%')
end

local isOdd = (listnum % 2) == 1
local rowstyle = args.evenstyle
if isOdd then rowstyle = args.oddstyle end

local evenOdd
if args.evenodd == 'swap' then
if isOdd then evenOdd = 'even' else evenOdd = 'odd' end
else
if isOdd then evenOdd = args.evenodd or 'odd' else evenOdd = args.evenodd or 'even' end
end

listCell
.css('padding', '0px')
.cssText(args.liststyle)
.cssText(rowstyle)
.cssText(args['list' .. listnum .. 'style'])
.addClass('navbox-list')
.addClass('navbox-' .. evenOdd)
.addClass(args.listclass)
.tag('div')
.css('padding', (listnum == 1 and args.list1padding) or args.listpadding or '0em 0.25em')
.newline()
.wikitext(args['list' .. listnum])

if listnum == 1 and args.image then
row
.tag('td')
.addClass('navbox-image')
.addClass(args.imageclass)
.css('width', '0%')
.css('padding', '0px 0px 0px 2px')
.cssText(args.imagestyle)
.attr('rowspan', 2 * #listnums - 1)
.tag('div')
.newline()
.wikitext(args.image)
end
end

--
-- Tracking categories
--
function renderTrackingCategories(builder)
local frame = mw.getCurrentFrame()

if not frame then return end

local s = frame:preprocess('{{#ifeq:{{NAMESPACE}}|{{ns:10}}|1|0}}{{SUBPAGENAME}}')
if mw.ustring.sub(s, 1, 1) == '0' then return end -- not in template space
local subpage = mw.ustring.lower(mw.ustring.sub(s, 2))
if subpage == 'doc' or subpage == 'sandbox' or subpage == 'testcases' then return end

for i, cat in ipairs(getTrackingCategories()) do
builder.wikitext('[[Category:' .. cat .. ']]')
end
end

function getTrackingCategories()
local cats = {}
if needsHorizontalLists() then table.insert(cats, 'Navigational boxes without horizontal lists') end
if hasBackgroundColors() then table.insert(cats, 'Navboxes using background colours') end
return cats
end

function needsHorizontalLists()
if border == 'child' or border == 'subgroup' or args.tracking == 'no' then return false end

local listClasses = {'plainlist', 'hlist', 'hlist hnum', 'hlist vcard', 'vcard hlist'}
for i, cls in ipairs(listClasses) do
if args.listclass == cls or args.bodyclass == cls then
return false
end
end

return true
end

function hasBackgroundColors()
return args.titlestyle or args.groupstyle
end

--
-- Main navbox tables
--
function renderMainTable()
local tbl = HtmlBuilder.create('table')
.attr('cellspacing', 0)
.addClass('nowraplinks')
.addClass(args.bodyclass)

if args.title and (args.state ~= 'plain' and args.state ~= 'off') then
tbl
.addClass('collapsible')
.addClass(args.state or 'autocollapse')
end

tbl.css('border-spacing', 0)
if border == 'subgroup' or border == 'child' or border == 'none' then
tbl
.addClass('navbox-subgroup')
.cssText(args.bodystyle)
.cssText(args.style)
else -- regular navobx - bodystyle and style will be applied to the wrapper table
tbl
.addClass('navbox-inner')
.css('background', 'transparent')
.css('color', 'inherit')
end
tbl.cssText(args.innerstyle)

renderTitleRow(tbl)
renderAboveRow(tbl)
for i, listnum in ipairs(listnums) do
renderListRow(tbl, listnum)
end
renderBelowRow(tbl)

return tbl
end

function p._navbox(navboxArgs)
args = navboxArgs

for k, v in pairs(args) do
local listnum = ('' .. k):match('^list(%d+)$')
if listnum then table.insert(listnums, tonumber(listnum)) end
end
table.sort(listnums)

border = trim(args.border or args[1] or '')

-- render the main body of the navbox
local tbl = renderMainTable()

-- render the appropriate wrapper around the navbox, depending on the border param
local res = HtmlBuilder.create()
if border == 'none' then
res.node(tbl)
elseif border == 'subgroup' or border == 'child' then
-- We assume that this navbox is being rendered in a list cell of a parent navbox, and is
-- therefore inside a div with padding:0em 0.25em. We start with a </div> to avoid the
-- padding being applied, and at the end add a <div> to balance out the parent's </div>
res
.tag('/div', {unclosed = true})
.done()
.node(tbl)
.tag('div', {unclosed = true})
else
res
.tag('table')
.attr('cellspacing', 0)
.addClass('navbox')
.css('border-spacing', 0)
.cssText(args.bodystyle)
.cssText(args.style)
.tag('tr')
.tag('td')
.css('padding', '2px')
.node(tbl)
end

renderTrackingCategories(res)

return tostring(res)
end

function p.navbox(frame)
-- ParserFunctions considers the empty string to be false, so to preserve the previous
-- behavior of {{navbox}}, change any empty arguments to nil, so Lua will consider
-- them false too.
local args = {}
local parent_args = frame:getParent().args;

-- Out of order parsing bug.
local temp;
temp = parent_args.title;
temp = parent_args.above;
for i = 1, 20 do
temp = parent_args["group" .. tostring(i)];
temp = parent_args["list" .. tostring(i)];
end
temp = parent_args.below;

for k, v in pairs(parent_args) do
if v ~= '' then
args[k] = v
end
end
return p._navbox(args)
end

return p

Teste

2013-08-01T18:25:44Z

Admin:

Predefinição:Underlinked

2013-08-01T18:24:58Z

Admin: uma edição

{{#ifeq:{{NAMESPACE}}|{{<includeonly>subst:</includeonly>NAMESPACE}}|<includeonly>[[Category:Pages with incorrectly substituted templates|{{PAGENAME}}]]</includeonly>|}}{{Ambox
| name = Underlinked
| type = style
| image = [[File:Ambox wikify.svg|50x40px|link=|alt=]]
| issue = This {{{1|article}}} '''needs more [[Wikipedia:Manual of Style/Linking|links to other articles]] to help [[WP:BUILD|integrate it into the encyclopedia]]'''.
| fix = Please help [{{fullurl:{{FULLPAGENAME}}|action=edit}} improve this article] by adding links [[Wikipedia:Only make links that are relevant to the context|that are relevant to the context]] within the existing text.
| date = {{{date|}}}
| cat = Articles with too few wikilinks
| all = All articles with too few wikilinks
| cat2 = Articles covered by WikiProject Wikify
| all2 = All articles covered by WikiProject Wikify
}}<noinclude>
{{Documentation}}
</noinclude>

Predefinição:Sidebar

2013-08-01T18:24:57Z

Admin: uma edição

{{#ifeq:{{{child|}}}|yes||<table class="vertical-navbox {{#ifeq:{{{wraplinks|}}}|true||nowraplinks}} {{{bodyclass|{{{class|}}}}}}" cellspacing="{{#if:{{{cellspacing|}}} |{{{cellspacing}}} |5}}" cellpadding="{{#if:{{{cellpadding|}}} |{{{cellpadding}}} |0}}" style="float:{{#if:{{{float|}}} |{{{float}}} |right}};clear:{{#ifeq:{{{float|}}}|none |both |{{#if:{{{float|}}} |{{{float}}} |right}}}};width:{{#if:{{{width|}}} |{{{width}}} |22.0em}};{{#switch:{{{float|}}} |left=margin:0 1.0em 1.0em 0; |none|right|#default=margin:0 0 1.0em 1.0em;}}background:#f9f9f9;border:1px solid #aaa;padding:0.2em;border-spacing:0.4em 0;text-align:center;line-height:1.4em;font-size:88%;{{{bodystyle|{{{style|}}}}}}">}}{{#ifeq:{{{child|}}}|yes||{{#if:{{{outertitle|}}}
|<caption class="{{{outertitleclass|}}}" style="padding-bottom:0.2em;font-size:125%;line-height:1.2em;font-weight:bold;{{{outertitlestyle|}}}">{{{outertitle}}}</caption>}}}}{{#ifeq:{{{child|}}}|yes||{{#if:{{{topimage|}}}
|<tr><td class="{{{topimageclass|}}}" style="padding:0.4em 0;{{{topimagestyle|}}}">{{{topimage}}}{{#if:{{{topcaption|}}} |<div style="padding-top:0.2em;line-height:1.2em;{{{topcaptionstyle|}}}">{{{topcaption}}}</div>}}</td>
</tr>
}}}}{{#ifeq:{{{child|}}}|yes||{{#if:{{{pretitle|}}}
|<tr><td class="{{{pretitleclass|}}}" style="{{{basestyle|}}};{{#if:{{{topimage|}}} |padding-top:0.2em |padding-top:0.4em}};line-height:1.2em;{{{pretitlestyle|}}}">{{{pretitle}}}</td>
</tr>
}}}}{{#if:{{{title|}}}
|{{#ifeq:{{{child|}}}|yes||<tr><th class="{{{titleclass|}}}" style="{{{basestyle|}}};padding:0.2em 0.4em 0.2em;{{#if:{{{pretitle|}}} |padding-top:0}};font-size:145%;line-height:1.2em;{{{titlestyle|}}}">}}{{{title}}}</th>
</tr>
}}{{#if:{{{image|}}}
|<tr><td class="{{{imageclass|}}}" style="padding:0.2em 0 0.4em;{{{imagestyle|}}}">{{{image}}}{{#if:{{{caption|}}} |<div style="padding-top:0.2em;line-height:1.2em;{{{captionstyle|}}}">{{{caption}}}</div>}}</td>
</tr>
}}{{#if:{{{above|}}}
|<tr><td class="{{{aboveclass|}}}" style="padding:0.3em 0.4em 0.3em;font-weight:bold;{{{abovestyle|}}}">
{{{above}}}</td>
</tr>
}}{{#if: {{{heading1|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading1style|}}}">
{{{heading1}}}</th>
</tr>
}}{{#if:
{{{content1|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content1style|}}}">
{{{content1}}}</td>
</tr>
}}{{#if: {{{heading2|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading2style|}}}">
{{{heading2}}}</th>
</tr>
}}{{#if:
{{{content2|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content2style|}}}">
{{{content2}}}</td>
</tr>
}}{{#if: {{{heading3|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading3style|}}}">
{{{heading3}}}</th>
</tr>
}}{{#if:
{{{content3|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content3style|}}}">
{{{content3}}}</td>
</tr>
}}{{#if: {{{heading4|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading4style|}}}">
{{{heading4}}}</th>
</tr>
}}{{#if:
{{{content4|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content4style|}}}">
{{{content4|}}}</td>
</tr>
}}{{#if: {{{heading5|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading5style|}}}">
{{{heading5}}}</th>
</tr>
}}{{#if:
{{{content5|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content5style|}}}">
{{{content5}}}</td>
</tr>
}}{{#if: {{{heading6|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading6style|}}}">
{{{heading6}}}</th>
</tr>
}}{{#if:
{{{content6|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content6style|}}}">
{{{content6}}}</td>
</tr>
}}{{#if: {{{heading7|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading7style|}}}">
{{{heading7}}}</th>
</tr>
}}{{#if:
{{{content7|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content7style|}}}">
{{{content7}}}</td>
</tr>
}}{{#if: {{{heading8|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading8style|}}}">
{{{heading8}}}</th>
</tr>
}}{{#if:
{{{content8|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content8style|}}}">
{{{content8}}}</td>
</tr>
}}{{#if: {{{heading9|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading9style|}}}">
{{{heading9}}}</th>
</tr>
}}{{#if:
{{{content9|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content9style|}}}">
{{{content9}}}</td>
</tr>
}}{{#if: {{{heading10|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading10style|}}}">
{{{heading10}}}</th>
</tr>
}}{{#if:
{{{content10|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content10style|}}}">
{{{content10}}}</td>
</tr>
}}{{#if: {{{heading11|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading11style|}}}">
{{{heading11}}}</th>
</tr>
}}{{#if:
{{{content11|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content11style|}}}">
{{{content11}}}</td>
</tr>
}}{{#if: {{{heading12|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading12style|}}}">
{{{heading12}}}</th>
</tr>
}}{{#if:
{{{content12|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content12style|}}}">
{{{content12}}}</td>
</tr>
}}{{#if: {{{heading13|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading13style|}}}">
{{{heading13}}}</th>
</tr>
}}{{#if:
{{{content13|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content13style|}}}">
{{{content13}}}</td>
</tr>
}}{{#if: {{{heading14|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading14style|}}}">
{{{heading14}}}</th>
</tr>
}}{{#if:
{{{content14|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content14style|}}}">
{{{content14}}}</td>
</tr>
}}{{#if: {{{heading15|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading15style|}}}">
{{{heading15}}}</th>
</tr>
}}{{#if:
{{{content15|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content15style|}}}">
{{{content15}}}</td>
</tr>
}}{{#if: {{{heading16|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading16style|}}}">
{{{heading16}}}</th>
</tr>
}}{{#if:
{{{content16|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content16style|}}}">
{{{content16}}}</td>
</tr>
}}{{#if: {{{heading17|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading17style|}}}">
{{{heading17}}}</th>
</tr>
}}{{#if:
{{{content17|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content17style|}}}">
{{{content17}}}</td>
</tr>
}}{{#if: {{{heading18|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading18style|}}}">
{{{heading18}}}</th>
</tr>
}}{{#if:
{{{content18|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content18style|}}}">
{{{content18}}}</td>
</tr>
}}{{#if: {{{heading19|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading19style|}}}">
{{{heading19}}}</th>
</tr>
}}{{#if:
{{{content19|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content19style|}}}">
{{{content19}}}</td>
</tr>
}}{{#if: {{{heading20|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading20style|}}}">
{{{heading20}}}</th>
</tr>
}}{{#if:
{{{content20|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content20style|}}}">
{{{content20}}}</td>
</tr>
}}{{#if: {{{heading21|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading21style|}}}">
{{{heading21}}}</th>
</tr>
}}{{#if:
{{{content21|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content21style|}}}">
{{{content21}}}</td>
</tr>
}}{{#if: {{{heading22|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading22style|}}}">
{{{heading22}}}</th>
</tr>
}}{{#if:
{{{content22|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content22style|}}}">
{{{content22}}}</td>
</tr>
}}{{#if: {{{heading23|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading23style|}}}">
{{{heading23}}}</th>
</tr>
}}{{#if:
{{{content23|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content23style|}}}">
{{{content23}}}</td>
</tr>
}}{{#if: {{{heading24|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading24style|}}}">
{{{heading24}}}</th>
</tr>
}}{{#if:
{{{content24|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content24style|}}}">
{{{content24}}}</td>
</tr>
}}{{#if: {{{heading25|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading25style|}}}">
{{{heading25}}}</th>
</tr>
}}{{#if:
{{{content25|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content25style|}}}">
{{{content25}}}</td>
</tr>
}}{{#if: {{{heading26|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading26style|}}}">
{{{heading26}}}</th>
</tr>
}}{{#if:
{{{content26|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content26style|}}}">
{{{content26}}}</td>
</tr>
}}{{#if: {{{heading27|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading27style|}}}">
{{{heading27}}}</th>
</tr>
}}{{#if:
{{{content27|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content27style|}}}">
{{{content27}}}</td>
</tr>
}}{{#if: {{{heading28|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading28style|}}}">
{{{heading28}}}</th>
</tr>
}}{{#if:
{{{content28|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content28style|}}}">
{{{content28}}}</td>
</tr>
}}{{#if: {{{heading29|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading29style|}}}">
{{{heading29}}}</th>
</tr>
}}{{#if:
{{{content29|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content29style|}}}">
{{{content29}}}</td>
</tr>
}}{{#if: {{{heading30|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading30style|}}}">
{{{heading30}}}</th>
</tr>
}}{{#if:
{{{content30|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content30style|}}}">
{{{content30}}}</td>
</tr>
}}{{#if: {{{heading31|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading31style|}}}">
{{{heading31}}}</th>
</tr>
}}{{#if:
{{{content31|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content31style|}}}">
{{{content31}}}</td>
</tr>
}}{{#if: {{{heading32|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading32style|}}}">
{{{heading32}}}</th>
</tr>
}}{{#if:
{{{content32|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content32style|}}}">
{{{content32}}}</td>
</tr>
}}{{#if: {{{heading33|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading33style|}}}">
{{{heading33}}}</th>
</tr>
}}{{#if:
{{{content33|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content33style|}}}">
{{{content33}}}</td>
</tr>
}}{{#if: {{{heading34|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading34style|}}}">
{{{heading34}}}</th>
</tr>
}}{{#if:
{{{content34|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content34style|}}}">
{{{content34}}}</td>
</tr>
}}{{#if: {{{heading35|}}}|
<tr>
<th class="{{{headingclass|}}}" style="padding:0.1em;{{{basestyle|}}};{{{headingstyle|}}};{{{heading35style|}}}">
{{{heading35}}}</th>
</tr>
}}{{#if:
{{{content35|}}}|
<tr>
<td class="{{{contentclass|}}}" style="padding:0 0.1em 0.4em;{{{contentstyle|}}};{{{content35style|}}}">
{{{content35}}}</td>
</tr>
}}{{#if: {{{below|}}}
|<tr><td class="{{{belowclass|}}}" style="padding:0.3em 0.4em 0.3em;font-weight:bold;{{{belowstyle|}}}">
{{{below}}}</td>
</tr>
}}{{#ifeq:{{{child|}}}|yes||{{#switch:{{{navbar|{{{tnavbar|<noinclude>off</noinclude>}}}}}}
|none |off=
|#default=<tr><td style="text-align:right;font-size:115%;{{{navbarstyle|{{{tnavbarstyle|}}}}}}">{{navbar|{{{name|{{PAGENAME}}}}}|mini=1|fontstyle={{{navbarfontstyle|{{{tnavbarfontstyle|}}}}}}}}</td></tr>}}
</table>}}<noinclude>{{documentation}}</noinclude>

Predefinição:Template other

2013-08-01T18:24:57Z

Admin: uma edição

{{#switch:

{{#if:{{{demospace|}}}
| {{lc: {{{demospace}}} }} 
| {{#ifeq:{{NAMESPACE}}|{{ns:Template}}
| template
| other
}}
}}
| template = {{{1|}}}
| other
| #default = {{{2|}}}
}}<noinclude>

{{documentation}}

</noinclude>

Predefinição:Tl

2013-08-01T18:24:57Z

Admin: uma edição

{{[[Template:{{{1}}}|{{{1}}}]]}}<noinclude>

{{Documentation}}

</noinclude>

Predefinição:Tlx

2013-08-01T18:24:57Z

Admin: uma edição

<includeonly><code><nowiki>{{</nowiki>{{#if:{{{subst|}}}|[[Help:Substitution|subst]]:}}[[{{{LANG|}}}{{{SISTER|}}}{{ns:Template}}:{{{1|}}}|{{{1|}}}]]{{#if:{{{2|}}}|
|{{{2}}}
}}{{#if:{{{3|}}}|
|{{{3}}}
}}{{#if:{{{4|}}}|
|{{{4}}}
}}{{#if:{{{5|}}}|
|{{{5}}}
}}{{#if:{{{6|}}}|
|{{{6}}}
}}{{#if:{{{7|}}}|
|{{{7}}}
}}{{#if:{{{8|}}}|
|{{{8}}}
}}{{#if:{{{9|}}}|
|{{{9}}}
}}{{#if:{{{10|}}}|
|{{{10}}}
}}{{#if:{{{11|}}}|
|{{{11}}}
}}{{#if:{{{12|}}}|
|''...''
}}<nowiki>}}</nowiki></code></includeonly><noinclude>

{{documentation}}

</noinclude>

Predefinição:Transclude

2013-08-01T18:24:57Z

Admin: uma edição

{{#switch: {{NAMESPACE: {{{1}}} }}
|#default = {{FULLPAGENAME: {{{1}}} }} 
|{{ns:0}} =
{{#ifeq: {{NAMESPACE: {{{1}}} }} | {{NAMESPACE: Template{{{1}}} }}
| Template:{{{1}}} 
| {{PAGENAME: {{{1}}} }} 
}}
}}<noinclude>
{{documentation}}
</noinclude>

Predefinição:Pp-template

2013-08-01T18:24:56Z

Admin: uma edição

<includeonly>{{pp-meta
|type={{#switch:{{{demolevel|{{#ifeq:{{PROTECTIONLEVEL:edit}}-{{PROTECTIONLEVEL:move}}|-sysop|move|{{PROTECTIONLEVEL:edit}}}}}}}
|semi
|autoconfirmed=semi
|administrator
|full
|sysop=indef
|move=move
|#default=indef}}
|small={{{small|yes}}}
|demospace={{{demospace|}}}
|demolevel={{#ifeq:{{PAGENAME}}/{{NAMESPACE}}|{{SUBPAGENAME}}/{{ns:Template}}|{{{demolevel|undefined}}}|{{#ifeq:{{lc:{{SUBPAGENAME}}}}|sandbox|sysop|{{{demolevel|undefined}}}}}}}
|expiry=
|dispute=no
|icon-text=This {{#ifeq:{{NAMESPACE}}|{{ns:6}}|image, included in a high-risk template or message,|high-risk template}} is indefinitely {{#switch:{{{demolevel|{{#ifeq:{{PROTECTIONLEVEL:edit}}-{{PROTECTIONLEVEL:move}}|-sysop|move|{{PROTECTIONLEVEL:edit}}}}}}}
|semi
|autoconfirmed=semi-protected from editing
|move=move-protected
|administrator
|full
|sysop
|#default=protected from editing}} to prevent vandalism.
|reason-text=This {{#switch:{{NAMESPACE}}
|{{ns:image}}=image, used in one or more [[Wikipedia:High-risk templates|high-risk templates]]{{#switch:{{{demolevel|{{PROTECTIONLEVEL:edit}}}}}
|semi
|autoconfirmed=
|administrator
|full
|sysop=<nowiki> </nowiki>and/or [[Special:Allmessages|system messages]],
|#default=}}
|#default=[[Wikipedia:High-risk templates|high-risk template]]
}} has been [[Wikipedia:This page is protected|{{#switch:{{{demolevel|{{#ifeq:{{PROTECTIONLEVEL:edit}}-{{PROTECTIONLEVEL:move}}|-sysop|move|{{PROTECTIONLEVEL:edit}}}}}}}
|semi
|autoconfirmed=semi-
|move=move-
|administrator
|full
|sysop
|#default=}}protected]]{{#ifeq:{{PROTECTIONLEVEL:edit}}-{{PROTECTIONLEVEL:move}}|-sysop||<nowiki> </nowiki>from editing}} to prevent [[Wikipedia:Vandalism|vandalism]]. {{#switch:{{{demolevel|{{PROTECTIONLEVEL:edit}}}}}
|semi
|autoconfirmed=
|administrator
|full
|sysop
|#default={{#switch:{{NAMESPACE}}|{{ns:image}}=<br /><small>'''Do not move this image''' to [[commons:|Wikimedia Commons]].</small>}}}}
|categories={{{categories|{{#ifeq:{{NAMESPACE}}|{{ns:10}}|{{#switch:{{{demolevel|{{#ifeq:{{PROTECTIONLEVEL:edit}}-{{PROTECTIONLEVEL:move}}|-sysop|move|{{PROTECTIONLEVEL:edit}}}}}}}
|semi
|autoconfirmed=[[Category:Wikipedia semi-protected templates|{{PAGENAME}}]]{{#ifeq:{{PROTECTIONLEVEL:move}}|sysop|[[Category:Wikipedia move-protected templates|{{PAGENAME}}]]}}
|move=[[Category:Wikipedia move-protected templates|{{PAGENAME}}]]
|administrator
|full
|sysop
|#default=[[Category:Wikipedia protected templates|{{PAGENAME}}]]}}}}{{#ifeq:{{NAMESPACE}}|{{ns:6}}|[[Category:{{#switch:{{{demolevel|{{PROTECTIONLEVEL:edit}}}}}
|semi
|autoconfirmed=Semi-protected
|administrator
|full
|sysop
|#default=Protected}} images|{{PAGENAME}}]]}}}}}}}</includeonly><noinclude>
{{pp-template|categories=no}} 
{{pp-template|small=no}} 
{{Documentation}}

</noinclude>

Predefinição:Purge

2013-08-01T18:24:56Z

Admin: uma edição

<span class="noprint plainlinks purgelink">[{{fullurl:{{{page|{{FULLPAGENAME}}}}}|action=purge}} <span title="Purge this page">{{{1|Purge}}}</span>]</span><noinclude>
{{documentation}}
</noinclude>

Predefinição:Ombox/core

2013-08-01T18:24:55Z

Admin: uma edição

<table class="plainlinks ombox {{#ifeq:{{{small}}}|yes|mbox-small}}
{{#switch:{{{type|}}}
| speedy = ombox-speedy
| delete = ombox-delete
| content = ombox-content
| style = ombox-style
| move = ombox-move
| protection = ombox-protection
| notice 
| #default = ombox-notice
}} {{{class|}}}" style="{{{style|}}}">
<tr>
{{#ifeq:{{{image|}}}|none
| <td class="mbox-empty-cell"></td>
| <td class="mbox-image">
{{#if:{{{image|}}}
| {{{image}}}
| [[Image:{{#switch:{{{type|}}}
| speedy = Imbox speedy deletion.png
| delete = Imbox deletion.png
| content = Imbox content.png
| style = Edit-clear.svg
| move = Imbox move.png
| protection = Imbox protection.png
| notice 
| #default = Imbox notice.png
}} | {{#ifeq:{{{small|}}}|yes
| 30x30px
| 40x40px
}}|link=|alt=]]
}}</td>
}}
<td class="mbox-text" style="{{{textstyle|}}}"> {{{text}}} </td>
{{#if:{{{imageright|}}}
| {{#ifeq:{{{imageright|}}}|none
| 
| <td class="mbox-imageright"> {{{imageright}}} </td>
}}
}}
</tr>
</table>{{#switch:{{{type|}}}
| 
| speedy
| delete
| content
| style
| move
| protection
| notice = 
| #default = <div style="text-align: center;">This message box is using an invalid "type={{{type|}}}" parameter and needs fixing.</div>[[Category:Wikipedia message box parameter needs fixing|{{main other|Main:}}{{FULLPAGENAME}}]]
}}<noinclude>

{{documentation}}

</noinclude>

Predefinição:POV

2013-08-01T18:24:55Z

Admin: uma edição

{{Ambox
| name = POV
| subst = <includeonly>{{subst:substcheck}}</includeonly>
| small = {{{small|}}}
| type = content
| class = ambox-POV
| image = [[File:Unbalanced scales.svg|50x40px|link=]]
| issue = The '''[[Wikipedia:Neutral point of view|neutrality]] of this {{{what|article}}} is [[Wikipedia:NPOV dispute|disputed]]'''.
| talk = {{{talk|{{{1|#}}}}}}
| fix = Please do not remove this message until the [[WP:NPOVD#What is an NPOV dispute?|dispute is resolved]].
| date = {{{date|}}}
| cat = NPOV disputes
| all = All NPOV disputes
}}<noinclude>
{{Documentation}}
</noinclude>

Predefinição:Para

2013-08-01T18:24:55Z

Admin: uma edição

<code style="white-space:nowrap;"><nowiki>|</nowiki>{{#if:{{{1|}}}|{{{1}}}<nowiki>=</nowiki>}}{{{2|}}}</code><noinclude>
{{Documentation}}

</noinclude>

Predefinição:Pp-meta

2013-08-01T18:24:55Z

Admin: uma edição

{{#ifeq:{{#switch:{{lc:{{{type}}}}}
|move={{#ifeq:
{{#switch:{{lc:{{{demolevel|undefined}}}}}
|semi |autoconfirmed = autoconfirmed
|administrator |full |sysop = sysop
|undefined = {{PROTECTIONLEVEL:move}}
|#default = }}
|sysop|yes|no
}}
|create={{#if:
{{#switch:{{lc:{{{demolevel|undefined}}}}}
|semi |autoconfirmed = autoconfirmed
|administrator |full |sysop = sysop
|undefined = {{PROTECTIONLEVEL:create}}
|#default = }}
|yes|no
}}
|pc1 ={{#ifeq:
{{#switch:{{lc:{{{demolevel|undefined}}}}}
|pc1 = autoconfirmed 
|undefined = {{PENDINGCHANGELEVEL}}
|#default = }}
|autoconfirmed
|yes|no
}}
|pc2 ={{#ifeq:
{{#switch:{{lc:{{{demolevel|undefined}}}}}
|pc2 = review 
|undefined = {{PENDINGCHANGELEVEL}}
|#default = }}
|review
|yes|no
}}
|#default={{#if:
{{#switch:{{lc:{{{demolevel|undefined}}}}}
|semi |autoconfirmed = autoconfirmed
|administrator |full |sysop = sysop
|undefined = {{PROTECTIONLEVEL:edit}}
|#default = }}
|{{#ifeq:{{#switch:{{lc:{{{disallowlevel|}}}}}
|semi |autoconfirmed = autoconfirmed
|administrator |full |sysop = sysop
|#default = }}
|{{#switch:{{lc:{{{demolevel|undefined}}}}}
|semi |autoconfirmed = autoconfirmed
|administrator |full |sysop = sysop
|undefined = {{PROTECTIONLEVEL:edit}}
|#default = }}
|no|yes
}}
|no}}
}}|yes|{{#ifeq:{{lc:{{{small|}}}}}|yes|
{{#switch:{{lc:{{{type}}}}}
| pc1 | pc2 = <div class="metadata topicon nopopups" id="protected-icon" style="display:none; right:25px;">
| #default = <div class="metadata topicon nopopups" id="protected-icon" style="display:none; right:55px;">
}}[[Image:{{{image|{{#switch:{{lc:{{{type}}}}}
|full=Padlock.svg
|semi=Padlock-silver.svg
|pc1=Padlock-silver-light.svg
|pc2=Padlock-orange.svg
|move=Padlock-olive.svg
|indef=Padlock-red.svg
|office=Padlock-black.svg
|create=Padlock-skyblue.svg
|#default=Transparent.gif
}}}}}|20px|link={{{icon-link|Wikipedia:Protection policy#{{lc:{{{type}}}}}}}}|{{{icon-text|{{#switch:{{lc:{{{type}}}}}
|pc1 = All edits by unregistered and new users are subject to review
|pc2 = All edits by users who are not reviewers or administrators are subject to review
|#default = This {{pp-meta/pagetype}} is {{#switch:{{lc:{{{type}}}}}
|semi=semi-
|move=move-
|indef=permanently<nowiki> </nowiki>
|create=creation-
|office=
|full
|#default=
}}protected
}}{{#ifeq:{{lc:{{{type}}}}}|indef||{{#if:{{{expiry|}}}|<nowiki> </nowiki>until {{#time:F j, Y|{{{expiry}}}}}}}}}{{#if:{{{icon-reason|}}}|<nowiki> </nowiki>{{{icon-reason}}}}}.}}}|alt=Page {{#switch:{{lc:{{{type}}}}}
|pc1=protected with pending changes level 1
|pc2=protected with pending changes level 2
|semi=semi-protected
|move=move-protected
|indef=permanently protected
|create=creation-protected
|office=protected
|full
|#default=protected
}}]]</div>
|
{{mbox
| name = {{{name|Pp-meta}}}
| subst = {{{subst|}}}
| demospace = {{{demospace|}}}
| type = protection
| image = [[Image:{{{image|{{#switch:{{lc:{{{type}}}}}
|full=Padlock.svg
|semi=Padlock-silver.svg
|pc1=Padlock-silver-light.svg
|pc2=Padlock-orange.svg
|move=Padlock-olive.svg
|indef=Padlock-red.svg
|office=Padlock-black.svg
|create=Padlock-skyblue.svg
|#default=Transparent.gif
}}}}}|40px|{{{icon-text|This page is {{#switch:{{lc:{{{type}}}}}
|pc1=protected with pending changes level 1
|pc2=protected with pending changes level 2
|semi=semi-protected
|move=move-protected
|indef=permanently protected
|create=creation-protected
|office=protected
|full
|#default=protected
}}.}}}]]
| text = '''{{{reason-text|{{#switch:{{lc:{{{type}}}}}
|full=This page is currently [[Wikipedia:This page is protected|protected]] from editing
|semi=Editing of this {{pp-meta/pagetype}} by [[Wikipedia:User access levels#Autoconfirmed_users|new]] or [[Wikipedia:User access levels#Anonymous_users|unregistered]] users is currently [[Wikipedia:Protection policy|disabled]]
|pc1=All edits made to this {{pp-meta/pagetype}} by [[Wikipedia:User access levels#Autoconfirmed_users|new]] or [[Wikipedia:User access levels#Anonymous_users|unregistered]] users are currently [[Wikipedia:Pending changes|subject to review]]
|pc2=All edits made to this {{pp-meta/pagetype}} by users who are not [[Wikipedia:Reviewing|reviewers]] or [[Wikipedia:Administrators|administrators]] are currently [[Wikipedia:Pending changes|subject to review]]
|move=This {{pp-meta/pagetype}} is currently [[Wikipedia:This page is protected|protected]] from [[Help:Moving a page|page moves]]
|indef=This page is [[Wikipedia:This page is protected|protected]] from editing ''indefinitely''
|office=This {{pp-meta/pagetype}} is currently [[Wikipedia:This page is protected|protected]] from editing
|create=[[Help:Starting a new page|Recreation]] of this {{pp-meta/pagetype}} [[Wikipedia:This page is protected|has been disabled]]
}}{{#ifeq:{{lc:{{{type}}}}}|indef||{{#if:{{{expiry|}}}| until {{#time:F j, Y|{{{expiry}}}}}}}}}{{{reason<includeonly>|</includeonly>}}}.}}}'''<br /> {{{explanation-text|{{#ifeq:{{lc:{{{dispute}}}}}|yes|This protection is '''not''' an endorsement of the {{#ifeq:{{{type}}}|move|[{{fullurl:Special:Log|type=move&page={{FULLPAGENAMEE}}}} current title]|[{{fullurl:{{FULLPAGENAMEE}}|action=history}} current version]}}.}} See the [[Wikipedia:Protection policy|protection policy]] and [{{fullurl:Special:Log|type={{#switch:{{lc:{{{type}}}}} | pc1 | pc2 = stable | #default = protect }}&page={{FULLPAGENAMEE}}}} {{#switch:{{lc:{{{type}}}}} | pc1 | pc2 = pending changes | #default = protection }} log] for more details. {{#switch:{{lc:{{{type}}}}}
|full|indef=Please discuss any changes on the [[{{TALKPAGENAME}}#{{#if:{{{section|}}}|{{{section}}}|top}}|talk page]]; you may use the {{tlx|editprotected}} template to ask an [[Wikipedia:Administrator|administrator]] to make an edit if it is supported by [[Wikipedia:Consensus|consensus]]. {{#ifeq:{{NAMESPACE}}|{{ns:8}}||You may also [[Wikipedia:Requests for page protection|request]] that this page be unprotected.}}
|semi=If you cannot edit this {{pp-meta/pagetype}} and you wish to make a change, you can {{#ifeq:{{NAMESPACE}}|{{TALKSPACE}}||[[Template:Editsemiprotected|request an edit]], [[{{TALKPAGENAME}}|discuss changes on the talk page]],}} [[Wikipedia:Requests for page protection#Current requests for unprotection|request unprotection]], [[Special:Userlogin|log in]], or [[Special:UserLogin/signup|create an account]].
|move=The page may still be edited but cannot be moved until unprotected. Please discuss any suggested moves on the [[{{TALKPAGENAME}}|talk page]] or at [[Wikipedia:Requested moves]]. You can also [[Wikipedia:Requests for page protection|request]] that the page be unprotected.
|office=If you can edit this page, please discuss all changes and additions on the [[{{TALKPAGENAME}}|talk page]] first. '''Do not remove protection from this page unless you are authorized by the Wikimedia Foundation to do so.'''
|create=Please see the {{#if:{{{xfd|}}}|'''[[{{{xfd}}}|deletion discussion]]''' or the}} [{{fullurl:Special:Log|type=delete&page={{FULLPAGENAMEE}}}} deletion log] for details of why this page was deleted. If you would like to create a page at this title, you must first [[Wikipedia:Requests for page protection|request]] for it to be unprotected, or contact the administrator who deleted the page for the deleted material to be restored. If unsuccessful, you can use [[Wikipedia:Deletion review|deletion review]].
}}}}}
}}
}}|<includeonly>[[Category:Wikipedia pages with incorrect protection templates]]</includeonly>}}<includeonly>{{#ifeq:{{lc:{{{categories|no}}}}}|no||{{{categories|}}}}}</includeonly><noinclude>

{{documentation}}

</noinclude>

Predefinição:Namespace detect

2013-08-01T18:24:54Z

Admin: uma edição

{{#invoke:Namespace detect|main}}<noinclude>

{{documentation}}

</noinclude>

Predefinição:Navbar

2013-08-01T18:24:54Z

Admin: uma edição

<includeonly><div class="noprint plainlinks hlist navbar {{#if:{{{mini|}}}|mini}}" style="{{{style|}}}">{{#if:{{{mini|}}}{{{plain|}}}||<span style="word-spacing:0;{{{fontstyle|}}}">{{{text|This box:}}} </span>}}{{#if:{{{brackets|}}}|<span style="margin-right:-0.125em;{{{fontstyle|}}}">[</span>}}<ul><li class="nv-view">[[{{transclude|{{{1}}}}}|<span title="View this template" style="{{{fontstyle|}}}">{{#if:{{{mini|}}}|v|view}}</span>]]</li><li class="nv-talk">[[{{TALKPAGENAME:{{transclude|{{{1}}}}}}}|<span title="Discuss this template" style="{{{fontstyle|}}}">{{#if:{{{mini|}}}|t|talk}}</span>]]</li>{{#if:{{{noedit|}}}||<li class="nv-edit">[{{fullurl:{{transclude|{{{1}}}}}|action=edit}} <span title="Edit this template" style="{{{fontstyle|}}}">{{#if:{{{mini|}}}|e|edit}}</span>]</li>}}</ul>{{#if:{{{brackets|}}}|<span style="margin-left:-0.125em;{{{fontstyle|}}}">]</span>}}</div></includeonly><noinclude>

{{documentation}}
</noinclude>

Predefinição:Navbox

2013-08-01T18:24:54Z

Admin: uma edição

{{#invoke: Navbox | navbox }}<noinclude>{{documentation}}</noinclude>

Predefinição:Ombox

2013-08-01T18:24:54Z

Admin: uma edição

{{#ifeq:{{{small|}}}|yes
| {{ombox/core
| small = yes
| type = {{{type|}}}
| image = {{#if:{{{smallimage|}}}| {{{smallimage}}} | {{{image|}}} }}
| imageright = {{#if:{{{smallimageright|}}} | {{{smallimageright}}} | {{{imageright|}}} }}
| class = {{{class|}}}
| style = {{{style|}}}
| textstyle = {{{textstyle|}}}
| text = {{#if:{{{smalltext|}}}| {{{smalltext}}} | {{{text}}} }}
}}
| {{ombox/core
| type = {{{type|}}}
| image = {{{image|}}}
| imageright = {{{imageright|}}}
| class = {{{class|}}}
| style = {{{style|}}}
| textstyle = {{{textstyle|}}}
| text = {{{text}}}
}}
}}<noinclude>{{documentation}}</noinclude>

Predefinição:Mbox templates see also

2013-08-01T18:24:53Z

Admin: uma edição

There are several meta-templates in the mbox family:
* {{tl|ambox}} – For article message boxes.
* {{tl|cmbox}} – For category message boxes.
* {{tl|imbox}} – For file (image) page message boxes.
* {{tl|mbox}} – Has namespace detection, for message boxes that are used on several types of pages and thus need to change style depending on what page they are used on.
* {{tl|ombox}} – For other pages message boxes.
* {{tl|tmbox}} – For talk page message boxes.

Closely related meta-templates:
* {{tl|asbox}} – For article stub message boxes.
* {{tl|dmbox}} – For disambiguation and set index message boxes.
* {{tl|fmbox}} – For header and footer message boxes.

<noinclude>
{{documentation}}

</noinclude>

Predefinição:Multiple issues

2013-08-01T18:24:53Z

Admin: uma edição

{{Ambox
|name = Multiple issues
|doc = no
|subst = <includeonly>{{subst:</includeonly><includeonly>substcheck}}</includeonly>
|class = ambox-multiple_issues compact-ambox
|type = content
|text = '''This {{#if:{{{section|}}}
|section
|article
}} has multiple issues'''. Please help '''[{{fullurl:{{FULLPAGENAME}}|action=edit}} improve it]''' or discuss these issues on the '''[[{{TALKPAGENAME}}|talk page]]'''.{{{1|}}}{{#if:{{{BLP unsourced|{{{BLPunsourced|}}}}}}|
|{{Multiple issues/message|{{{section|}}}
| name = {{{unreferenced|{{{unref|}}}}}}
| template = Unreferenced
}}
}}{{Multiple issues/message|{{{section|}}}
| name = {{{BLP unsourced|{{{BLPunsourced|}}}}}}
| template = BLP unsourced
}}{{#if:{{{BLP sources|{{{BLPsources|}}}}}}|
|{{Multiple issues/message|{{{section|}}}
| name = {{{refimprove|}}}
| template = Refimprove
}}
}}{{Multiple issues/message|{{{section|}}}
| name = {{{BLP sources|{{{BLPsources|}}}}}}
| template = BLP sources
}}{{Multiple issues/message|{{{section|}}}
| name = {{{BLP IMDb-only refimprove|{{{BLP IMDB-only refimprove|}}}}}}
| template = BLP IMDb-only refimprove
}}{{Multiple issues/message|{{{section|}}}
| name = {{{BLP IMDb refimprove|{{{BLP IMDB refimprove|}}}}}}
| template = BLP IMDb refimprove
}}{{Multiple issues/message|{{{section|}}}
| name = {{{citation style|{{{citationstyle|{{{citation-style|}}}}}}}}}
| template = Citation style
}}{{Multiple issues/message|{{{section|}}}
| name = {{{citecheck|{{{cite check|}}}}}}
| template = Cite check
}}{{Multiple issues/message|{{{section|}}}
| name = {{{more footnotes|}}}
| template = More footnotes
}}{{Multiple issues/message|{{{section|}}}
| name = {{{no footnotes|}}}
| template = No footnotes
}}{{Multiple issues/message|{{{section|}}}
| name = {{{one source|{{{onesource|}}}}}}
| template = One source
}}{{Multiple issues/message|{{{section|}}}
| name = {{{primary sources|{{{primarysources|}}}}}}
| template = Primary sources
}}{{Multiple issues/message|{{{section|}}}
| name = {{{unreliable sources|{{{unreliable|}}}}}}
| template = Unreliable sources
}}{{Multiple issues/message|{{{section|}}}
| name = {{{abbreviations|}}}
| template = Abbreviations
}}{{Multiple issues/message|{{{section|}}}
| name = {{{advert|}}}
| template = Advert
}}{{Multiple issues/message|{{{section|}}}
| name = {{{autobiography|}}}
| template = Autobiography
}}{{#if:{{{cleanup|}}}
|{{Cleanup
|1={{#if:{{{section|}}}|section}}
|reason={{{reason|}}}
|date={{Check date|{{{cleanup|}}}}}
|demospace={{{demospace|}}}
|nocat={{{nocat|}}}
}}
}}{{Multiple issues/message|{{{section|}}}
| name = {{{cleanup-laundry|{{{laundrylists|{{{laundry|}}}}}}}}}
| template = Cleanup-laundry
}}{{Multiple issues/message|{{{section|}}}
| name = {{{cleanup-link rot|{{{linkrot|}}}}}}
| template = Cleanup-link rot
}}{{Multiple issues/message|{{{section|}}}
| name = {{{cleanup-reorganize|{{{restructure|{{{reorganisation|{{{organize|}}}}}}}}}}}}
| template = Cleanup-reorganize
}}{{Multiple issues/message|{{{section|}}}
| name = {{{cleanup-rewrite|{{{rewrite|}}}}}}
| template = Cleanup-rewrite
}}{{Multiple issues/message|{{{section|}}}
| name = {{{cleanup-spam|{{{spam|}}}}}}
| template = Cleanup-spam
}}{{Multiple issues/message|{{{section|}}}
| name = {{{COI|{{{coi|}}}}}}
| template = COI
}}{{Multiple issues/message|{{{section|}}}
| name = {{{colloquial|}}}
| template = Colloquial
}}{{Multiple issues/message|{{{section|}}}
| name = {{{confusing|}}}
| template = Confusing
}}{{Multiple issues/message|{{{section|}}}
| name = {{{context|}}}
| template = Context
}}{{Multiple issues/message|{{{section|}}}
| name = {{{contradict|}}}
| template = Contradict
}}{{Multiple issues/message|{{{section|}}}
| name = {{{copy edit|{{{copyedit|}}}}}}
| template = Copy edit
}}{{Multiple issues/message|{{{section|}}}
| name = {{{criticism section|{{{criticisms|}}}}}}
| template = Criticism section
}}{{Multiple issues/message|{{{section|}}}
| name = {{{crystal|}}}
| template = Crystal
}}{{Multiple issues/message|{{{section|}}}
| name = {{{dead end|{{{deadend|}}}}}}
| template = Dead end
}}{{Multiple issues/message|{{{section|}}}
| name = {{{disputed|}}}
| template = Disputed
}}{{Multiple issues/message|{{{section|}}}
| name = {{{essay-like|{{{essay|}}}}}}
| template = Essay-like
}}{{Multiple issues/message|{{{section|}}}
| name = {{{example farm|{{{examplefarm|}}}}}}
| template = Example farm
}}{{Multiple issues/message|{{{section|}}}
| name = {{{external links|}}}
| template = External links
}}{{Multiple issues/message|{{{section|}}}
| name = {{{fanpov|{{{fansite|}}}}}}
| template = Fanpov
}}{{Multiple issues/message|{{{section|}}}
| name = {{{fiction|}}}
| template = Fiction
}}{{Multiple issues/message|{{{section|}}}
| name = {{{game guide|{{{gameguide|}}}}}}
| template = Game guide
}}{{Multiple issues/message|{{{section|}}}
| name = {{{globalize|}}}
| template = Globalize
}}{{Multiple issues/message|{{{section|}}}
| name = {{{histinfo|}}}
| template = Historical information needed
}}{{Multiple issues/message|{{{section|}}}
| name = {{{hoax|}}}
| template = Hoax
}}{{Multiple issues/message|{{{section|}}}
| name = {{{howto|}}}
| template = Howto
}}{{Multiple issues/message|{{{section|}}}
| name = {{{inappropriate person|}}}
| template = Inappropriate person
}}{{Multiple issues/message|{{{section|}}}
| name = {{{incomplete|}}}
| template = Incomplete
| demospace = {{{demospace|}}}
}}{{Multiple issues/message|{{{section|}}}
| name = {{{in-universe|}}}
| template = In-universe
}}{{Multiple issues/message|{{{section|}}}
| name = {{{lead missing|{{{intromissing|}}}}}}
| template = Lead missing
}}{{Multiple issues/message|{{{section|}}}
| name = {{{lead rewrite|{{{introrewrite|}}}}}}
| template = Lead rewrite
}}{{Multiple issues/message|{{{section|}}}
| name = {{{lead too long|{{{intro length|{{{intro-toolong|}}}}}}}}}
| template = Lead too long
}}{{Multiple issues/message|{{{section|}}}
| name = {{{lead too short|{{{intro-tooshort|}}}}}}
| template = Lead too short
}}{{Multiple issues/message|{{{section|}}}
| name = {{{like resume|{{{likeresume|}}}}}}
| template = Like resume
}}{{Multiple issues/message|{{{section|}}}
| name = {{{news release|{{{newsrelease|}}}}}}
| template = News release
}}{{Multiple issues/message|{{{section|}}}
| name = {{{notability|{{{notable|}}}}}}
| template = Notability
}}{{Multiple issues/message|{{{section|}}}
| name = {{{original research|}}}
| template = Original research
}}{{Multiple issues/message|{{{section|}}}
| name = {{{orphan|}}}
| template = Orphan
}}{{Multiple issues/message|{{{section|}}}
| name = {{{update|{{{out of date|}}}}}}
| template = Update
}}{{Multiple issues/message|{{{section|}}}
| name = {{{overly detailed|{{{fancruft|}}}}}}
| template = Overly detailed
}}{{Multiple issues/message|{{{section|}}}
| name = {{{peacock|}}}
| template = Peacock
}}{{Multiple issues/message|{{{section|}}}
| name = {{{plot|}}}
| template = Plot
}}{{Multiple issues/message|{{{section|}}}
| name = {{{POV|{{{NPOV|{{{pov|{{{npov|}}}}}}}}}}}}
| template = POV
}}{{Multiple issues/message|{{{section|}}}
| name = {{{POV-check|{{{pov-check|}}}}}}
| template = POV-check
}}{{Multiple issues/message|{{{section|}}}
| name = {{{prose|}}}
| template = Prose
}}{{Multiple issues/message|{{{section|}}}
| name = {{{over-quotation|{{{quote farm|}}}}}}
| template = Over-quotation
}}{{Multiple issues/message|{{{section|}}}
| name = {{{recentism|}}}
| template = Recentism
}}{{Multiple issues/message|{{{section|}}}
| name = {{{review|}}}
| template = Review
}}{{Multiple issues/message|{{{section|}}}
| name = {{{sections|}}}
| template = Sections
}}{{Multiple issues/message|{{{section|}}}
| name = {{{self-published|}}}
| template = Self-published
}}{{Multiple issues/message|{{{section|}}}
| name = {{{story|}}}
| template = Story
}}{{Multiple issues/message|{{{section|}}}
| name = {{{synthesis|}}}
| template = Synthesis
}}{{Multiple issues/message|{{{section|}}}
| name = {{{technical|{{{jargon|}}}}}}
| template = Technical
}}{{Multiple issues/message|{{{section|}}}
| name = {{{tone|{{{inappropriate tone|}}}}}}
| template = Tone
}}{{Multiple issues/message|{{{section|}}}
| name = {{{travel guide|{{{travelguide|}}}}}}
| template = Travel guide
}}{{Multiple issues/message|{{{section|}}}
| name = {{{trivia|}}}
| template = Trivia
}}{{Multiple issues/message|{{{section|}}}
| name = {{{unbalanced|}}}
| template = Unbalanced
}}{{Multiple issues/message|{{{section|}}}
| name = {{{very long|{{{long|{{{verylong|}}}}}}}}}
| template = Very long
}}{{Multiple issues/message|{{{section|}}}
| name = {{{weasel|}}}
| template = Weasel
}}
{{#ifeq:{{{2|a}}}|{{{2|b}}}|[[Category:Pages using multiple issues with incorrect parameters]]}}
}}<noinclude>
{{Documentation}}
</noinclude>

Predefinição:Multiple issues/message

2013-08-01T18:24:53Z

Admin: uma edição

{{#if:{{{name|}}}
|{{ {{{template}}}
|1={{#if:{{{1|}}}|section|article}}
|date={{Check date|{{{name}}}}}
|demospace={{{demospace|}}}
}}
}}<noinclude>
{{Documentation}}
</noinclude>

Predefinição:Fmbox

2013-08-01T18:24:52Z

Admin: uma edição

<table {{#if:{{{id|}}}|id="{{{id|}}}"}} class="plainlinks fmbox
{{#switch:{{{type|}}}
| warning = fmbox-warning
| editnotice = fmbox-editnotice
| system 
| #default = fmbox-system
}} {{{class|}}}" style="{{{style|}}}">
<tr>
{{#ifeq:{{{image|}}}|none
| 
| <td class="mbox-image">
{{#if:{{{image|}}}
| {{{image}}}
| [[File:{{#switch:{{{type|}}}
| warning = Cmbox deletion.png
| editnotice = Imbox notice.png
| system 
| #default = Imbox notice.png
}}|40x40px|link=|alt=]]
}}</td>
}}
<td class="mbox-text" style="{{{textstyle|}}}"> {{{text}}} </td>
{{#if:{{{imageright|}}}
| <td class="mbox-imageright"> {{{imageright}}} </td>
}}
</tr>
</table>{{#switch:{{{type|}}}
| 
| warning
| editnotice
| system = 
| #default = <div style="text-align: center;">This message box is using an invalid "type={{{type|}}}" parameter and needs fixing.</div>[[Category:Wikipedia message box parameter needs fixing|{{main other|Main:}}{{FULLPAGENAME}}]]
}}<noinclude>
{{documentation}}

</noinclude>

Predefinição:High-risk

2013-08-01T18:24:52Z

Admin: uma edição

{{ombox
| type = content
| text =
'''This {{
#switch:{{NAMESPACE}}
|Module=Lua module
|#default=template
}} is used on [[Wikipedia:Database reports/Templates transcluded on the most pages|{{#if:{{{1|}}}|{{{1}}}|a very large number of}} pages]].'''<br />To avoid large-scale disruption and unnecessary server load, any changes to this {{
#switch:{{NAMESPACE}}
|Module=module
|#default=template
}} should first be tested in its [[{{#ifeq:{{SUBPAGENAME}}|doc| {{SUBJECTSPACE}}:{{BASEPAGENAME}} | {{SUBJECTPAGENAME}} }}/sandbox|/sandbox]] or [[{{#ifeq:{{SUBPAGENAME}}|doc| {{SUBJECTSPACE}}:{{BASEPAGENAME}} | {{SUBJECTPAGENAME}} }}/testcases|/testcases]] subpages{{
#switch:{{NAMESPACE}}
|Module=.
|#default=, or in your own [[Wikipedia:Subpages#How to create user subpages|user space]].
}} The tested changes can then be added to this page in one single edit. Please consider discussing any changes on {{#if:{{{2|}}}|[[{{{2}}}]]|the [[{{#ifeq:{{SUBPAGENAME}}|doc| {{TALKSPACE}}:{{BASEPAGENAME}} | {{TALKPAGENAME}} }}|talk page]]}} before implementing them.
}}<noinclude>
{{Documentation}}

</noinclude>

Predefinição:If pagename

2013-08-01T18:24:52Z

Admin: uma edição

{{#if:x 
| 
{{{ {{#if:{{{page|}}}| {{{page|}}} | {{FULLPAGENAME}} }} 
| 
{{{ {{#titleparts:{{#if:{{{page|}}}| {{{page|}}} | {{FULLPAGENAME}} }}|1|1}}/+
| 
{{#if:{{#titleparts:{{#if:{{{page|}}}| {{{page|}}} | {{FULLPAGENAME}} }}|0|2}}
| 
{{{ {{#titleparts:{{#if:{{{page|}}}| {{{page|}}} | {{FULLPAGENAME}} }}|1|1}}/*
| 
{{{ {{#titleparts:{{#if:{{{page|}}}| {{PAGENAME:{{{page|}}}}} | {{PAGENAME}} }}|1|1}}/*
| 
{{{ /{{#titleparts:{{#if:{{{page|}}}| {{{page|}}} | {{FULLPAGENAME}} }}|0|-1}}
| 
{{{ /{{lc: {{padleft:|8| {{#titleparts:{{#if:{{{page|}}}| {{{page|}}} | {{FULLPAGENAME}} }}|0|-1}}# }} }}*
| 
{{{ /{{lc: {{padleft:|6| {{#titleparts:{{#if:{{{page|}}}| {{{page|}}} | {{FULLPAGENAME}} }}|0|-1}}# }} }}*
| 
{{{ /{{lc: {{padleft:|4| {{#titleparts:{{#if:{{{page|}}}| {{{page|}}} | {{FULLPAGENAME}} }}|0|-1}}# }} }}* 
| {{{subpage| {{{other|}}} }}} 
}}}
}}}
}}}
}}}
}}}
}}}
| 
{{{ {{#if:{{{page|}}}| {{PAGENAME:{{{page|}}}}} | {{PAGENAME}} }}
| {{{basepage| {{{other|}}} }}} 
}}}
}} 
}}}
}}}
}}<noinclude>

{{documentation}}

</noinclude>

Predefinição:Mbox template family

2013-08-01T18:24:52Z

Admin: uma edição

{{Navbox
|name = mbox template family
|bodyclass = hlist
|title = [[Template:mbox|mbox]] template family

|group1 = Foundation
|list1 =
* [[Template:mbox|mbox]]

|group2 = [[Template:mbox#See also|Message types]] built using mbox
|list2 =
* [[Template:ambox|Article]]
** [[Template:asbox|stub]]
* [[Template:cmbox|Category]]
* [[Template:dmbox|Disambiguation]]
* [[Template:fmbox|Footer or header]]
* [[Template:imbox|Image]]
* [[Template:ombox|Other]]
* [[Template:tmbox|Talkpage]]

}}<noinclude>

[[Category:Wikipedia metatemplates]]
</noinclude>

Predefinição:Mbox templates

2013-08-01T18:24:52Z

Admin: uma edição

{{sidebar
| name = mbox templates
| title = Message box<br />meta-templates
| titlestyle = font-size: inherit
| contentstyle = text-align: left
| contentclass = plainlist
| style = width: auto
| content1 =
*{{tlx|ambox}}
*{{tlx|cmbox}}
*{{tlx|imbox}}
*{{tlx|mbox}}
*{{tlx|ombox}}
*{{tlx|tmbox}}
*{{tlx|asbox}}
*{{tlx|dmbox}}
*{{tlx|fmbox}}

}}<noinclude>{{documentation}}</noinclude>

Predefinição:Documentation/end box

2013-08-01T18:24:51Z

Admin: uma edição

<noinclude><div></noinclude><div style="clear: both;"></div>
</div>{{#if:

{{#ifeq: {{{link box|}}} | off
|
| {{{doc exist|yes}}}{{
#switch: {{SUBJECTSPACE}}
| {{ns:User}}
| {{ns:Template}} = yes
}}
}}

| {{fmbox
| id = documentation-meta-data
| image = none
| style = background-color: #ecfcf4;
| textstyle = font-style: italic;
| text =
{{#if: {{{link box|}}}
| {{{link box}}} 
| {{#if: {{{doc exist|yes}}}
| 
The above [[Wikipedia:Template documentation|documentation]] is [[Wikipedia:Transclusion|transcluded]] from [[{{{docpage|{{FULLPAGENAME}}/doc}}}]]. <small style="font-style: normal">([{{fullurl:{{{docpage|{{FULLPAGENAME}}/doc}}}|action=edit}} edit] | [{{fullurl:{{{docpage|{{FULLPAGENAME}}/doc}}}|action=history}} history])</small> <br />
}}{{#switch: {{SUBJECTSPACE}}
| {{ns:User}}
| {{ns:Template}} =
Editors can experiment in this template's {{
#ifexist: {{{sandbox| {{FULLPAGENAME}}/sandbox }}}
| [[{{{sandbox| {{FULLPAGENAME}}/sandbox }}}|sandbox]] <small style="font-style: normal">([{{fullurl: {{{sandbox| {{FULLPAGENAME}}/sandbox }}} | action=edit }} edit] <nowiki>|</nowiki> [{{fullurl:Special:ComparePages | page1={{urlencode:{{{template page|{{FULLPAGENAME}}}}}}}&page2={{urlencode:{{{sandbox|{{FULLPAGENAME}}/sandbox}}}}}}} diff])</small>
| sandbox <small style="font-style: normal">([{{fullurl: {{{sandbox| {{FULLPAGENAME}}/sandbox }}} | action=edit&preload=Template:Documentation/preload-sandbox }} create] <nowiki>|</nowiki> [{{fullurl: {{{sandbox| {{FULLPAGENAME}}/sandbox }}} | action=edit&preload={{urlencode:{{{template page|{{FULLPAGENAME}}}}}}}&summary={{urlencode:Create sandbox version of [[{{{template page|{{FULLPAGENAME}}}}}]]}} }} mirror])</small>
}} and {{
#ifexist: {{{testcases| {{FULLPAGENAME}}/testcases }}}
| [[{{{testcases| {{FULLPAGENAME}}/testcases }}}|testcases]] <small style="font-style: normal">([{{fullurl: {{{testcases| {{FULLPAGENAME}}/testcases }}} | action=edit }} edit])</small>
| testcases <small style="font-style: normal">([{{fullurl: {{{testcases| {{FULLPAGENAME}}/testcases }}} | action=edit&preload=Template:Documentation/preload-testcases }} create])</small>
}} pages. <br />
}}{{#if: {{{content|}}} {{{docname fed|}}}
|
| Please add categories to the [[{{{docpage|{{FULLPAGENAME}}/doc}}}|/doc]] subpage.
}}{{#switch: {{SUBJECTSPACE}}
| {{ns:File}} = 
| {{ns:Template}} =  [[Special:PrefixIndex/{{{template page|{{FULLPAGENAME}}}}}/|Subpages of this template]].
| #default =  [[Special:PrefixIndex/{{{template page|{{FULLPAGENAME}}}}}/|Subpages of this page]].
}}
}}{{#ifexist:{{FULLPAGENAME}}/Print
|<br />A [[Help:Books/for experts#Improving the book layout|print version]] of this template exists at [[/Print]]. If you make a change to this template, please update the print version as well.[[Category:Templates with print versions]]
}}
}}
}}{{#if:


{{#switch: {{SUBPAGENAME}}
| doc
| testcases = strange
}}


| <includeonly>[[Category:Wikipedia pages with strange ((documentation)) usage|{{main other|Main:}}{{FULLPAGENAME}}]]</includeonly>

}}<noinclude>
{{pp-template|small=yes}}
</noinclude>

Predefinição:Documentation/end box2

2013-08-01T18:24:51Z

Admin: uma edição

{{documentation/end box
| preload = {{{preload|}}} 
| content = {{{content|}}}
| link box = {{{link box|}}} 

| docpage =
{{#if: {{{1|}}}
| {{{1|}}}
| {{{docspace|{{NAMESPACE}}}}}:{{{template page|{{PAGENAME}}}}}/doc
}}
| doc exist =
{{#ifexist:
{{#if: {{{1|}}}
| {{{1|}}} 
| {{{docspace|{{NAMESPACE}}}}}:{{{template page|{{PAGENAME}}}}}/doc
}}
| yes
}}
| docname fed =
{{#if: {{{1|}}}
| yes
}}

| sandbox =
{{{docspace|{{NAMESPACE}}}}}:{{{template page|{{PAGENAME}}}}}/sandbox
| testcases =
{{{docspace|{{NAMESPACE}}}}}:{{{template page|{{PAGENAME}}}}}/testcases

| template page =
{{NAMESPACE}}:{{{template page|{{PAGENAME}}}}}

}}<noinclude>

{{pp-template}}

</noinclude>

Predefinição:Documentation/start box

2013-08-01T18:24:51Z

Admin: uma edição

<div id="template-documentation" class="template-documentation iezoomfix">{{#ifeq: {{{heading|¬}}} | 
| 
| <div style="padding-bottom: 3px; border-bottom: 1px solid #aaa; margin-bottom: 1ex;"><span style="{{#if: {{{heading-style|}}}
| {{{heading-style|}}}
| {{#ifeq: {{SUBJECTSPACE}} | {{ns:Template}}
| font-weight: bold; font-size: 125%
| font-size: 150%
}}
}}">{{#switch: {{{heading|¬}}}
| ¬ =

{{#switch: {{SUBJECTSPACE}}
| {{ns:Template}} = [[File:Template-info.png|50px|link=|alt=Documentation icon]] Template documentation
| {{ns:Module}} = [[File:Template-info.png|50px|link=|alt=Documentation icon]] Module documentation
| {{ns:File}} = Summary
| #default = Documentation
}}
| #default =

{{{heading|}}}
}}</span>{{
#if: {{{content|}}}
|
| 
<span class="mw-editsection plainlinks" id="doc_editlinks">{{
#if: {{{doc exist|yes}}}
| [[[{{{docpage|{{FULLPAGENAME}}/doc}}}|view]]] [[{{fullurl:{{{docpage|{{FULLPAGENAME}}/doc}}}|action=edit}} edit]] [[{{fullurl:{{{docpage|{{FULLPAGENAME}}/doc}}}|action=history}} history]] [{{purge|purge}}]
| 
[[{{fullurl:{{{docpage|{{FULLPAGENAME}}/doc}}}| action=edit&preload={{
#if: {{{preload|}}}
| {{urlencode:{{{preload}}}}}
| {{#ifeq: {{SUBJECTSPACE}} | {{ns:File}}
| Template:Documentation/preload-filespace
| Template:Documentation/preload
}} }} }} create]]
}}</span>
}}</div>
}}<noinclude></div>

{{pp-template}}

</noinclude>

Predefinição:Documentation/start box2

2013-08-01T18:24:51Z

Admin: uma edição

{{documentation/start box
| preload = {{{preload|}}} 
| heading = {{{heading|¬}}} 
| heading-style = {{{heading-style|}}}
| content = {{{content|}}}

| docpage =
{{#if: {{{1|}}}
| {{{1|}}}
| {{{docspace|{{NAMESPACE}}}}}:{{{template page|{{PAGENAME}}}}}/doc
}}

| doc exist =
{{#ifexist:
{{#if: {{{1|}}}
| {{{1|}}} 
| {{{docspace|{{NAMESPACE}}}}}:{{{template page|{{PAGENAME}}}}}/doc
}}
| yes
}}

}}<noinclude>

{{pp-template}}

</noinclude>

Predefinição:Documentation/template page

2013-08-01T18:24:51Z

Admin: uma edição

{{#switch: {{SUBPAGENAME}}
| sandbox
| testcases = {{BASEPAGENAME}}
| #default = {{PAGENAME}}
}}<noinclude>{{documentation|content=
This subtemplate of {{tl|documentation}} is used to determine the template page name.
}}</noinclude>