= Veiligheids waarschuwingen =

'''Let op''': Het gebeurd regelmatig dat asterisk machines gehacked worden, met als reden naar dure telefoon nummers te bellen, om zo geld te verdienen.

Volg daarom deze waarschuwingen op om dit te voorkomen:

 * Zorg dat u uw SIP poort (5060/udp) nooit open staat voor connecties vanaf internet. (in uw SYN-3 firewall)
 * Zorg dat uw SCC en ssh poorten nooit open staan voor connecties vanaf internet. (in uw SYN-3 firewall)
 * Gebruik altijd lange niet te raden secrets voor alle SIP accounts die u aanmaakt in FreePBX. (SIP word regelmatig gebruteforced, indien uw firewall toch open staat)
 * Zorg dat u FreePBX altijd up te date houdt.
 

= Free PBX Installatie =

FreePBX is de admin panel voor uw Asterisk voice server. Dit is de aanbevolen manier om een asterisk server met SYN-3 op te zetten.

(een andere manier is om de Asterisk_gui panel te gebruiken, maar deze is minder uitgebreid en word niet meer ontwikkeld [wiki:help/scc/asterisk/asterisk zie >>] )

U dient een aantal stappen te nemen om deze te installeren en configuren.

== SYN-3 ==

Installeer SYN-3 versie 4.4.2 of hoger. Zie ook [wiki:howto/Install SYN-3 installatie]

== licentie ==

 * SYN-3 -> registratie -> Ga naar shop...
 * Upgrade licentie met extra opties...
 * Aanschaffen Asterisk FreePBX
 * Ga terug naar de SCC en installeer de nieuwe update(s).

== inloggen ==

 * ga met de browser naar http://serveradress
 * login op de freepbx panel
 * inloggen met admin/admin

== wachtwoord resetten ==

Verander het wachtwoord:

 * ga naar ''Setup -> Administrators''
 * klik op de ''admin'' gebruiker. (helemaal rechts!)
 * voer een nieuw wachtwoord in
 * druk op ''submit''


== FreePBX updates ==

FreePBX heeft een eigen update systeem. Voordat u verder gaat is het raadzaam eerst te updaten naar de laatste stabiele versie.

 * ga naar ''Tools -> Module Admin ''
 * klik ''Check for updates online''
 * klik ''Upgrade all''
 * klik ''Process''

=== Grotere updates ===

Vaak zijn er nog een aantal major-upgrades nodig, voer deze procedure uit totdat u de laatste stabiele versie heeft:
 * ga naar ''Tools -> Module Admin ''
 * klik ''Check for updates online''
 * klik ''2.x upgrade tool'' -> ''Download and install''
 * klik ''Process'' -> ''Confirm''
 * Nu verschijnt er een nieuwe menu eus aan de linker kant: ''2.x Upgrade Tool''
 * Volg de instructies.
 * Na het uitvoeren van alle updates kan het zijn dat er een volgende 2.x upgrade tool bij de updates staat. Voer de procedure net zo lang uit totdat u de laatste versie heeft. (op dit moment 2.9)

Soms is het nodig om extra stappen te nemen voor u een update kunt installeren. Deze stappen worden dan door FreePBX aangegeven.

Op dit moment is het nodig deze procedure een aantal keren uit te voeren om bij versie 2.9 van freePBX te komen.

 * Start de service ''Asterisk voice server'' opnieuw op via de SCC.

= SIP provider configuratie =

== NAT gebruiken ==

Indien uw SYN-3 server geen extern IP heeft, gebruikt u NAT in uw netwerk. In dat geval is het nodig wat extra instellingen te doen in asterisk.

 * Installeer de FreePBX module: ''Asterisk SIP settings''
 * Ga naar ''Tools -> Asterisk SIP settings''
 * Zet NAT op yes.
 * Klik op ''Autoconfigure''
 * Controleer eventuele andere settings en sla op.

== SIP provider toevoegen ==

We gaan er vanuit dat u een SIP account heeft bij een SIP provider.

 * Ga naar Trunks
 * Kies Add SIP Trunk

 * Vul bij de bovenste ''Trunk name'' een omschrijvende naam in. Voorbeeld: '''Voipcheap trunk 031123456'''

 * Bij ''Outgoing settings'':
  * Vul hier bij ''Trunk name'' de username in die u gekregen heeft van uw provider. Voorbeeld: '''uwgebruikersnaam'''
  * Vul bij het vakje ''PEER Details'' het volgende in:
{{{
host=sip.uwprovider.com
username=uwgebruikersnaam
secret=uwwachtwoord
type=peer
insecure=very

}}}

 * Bij ''Incoming settings'':
  * Haal het vakje ''USER details'' helemaal leeg.

 * Afhankelijk van de provider vult u de bij ''Registration String'' het volgende in:
  * Werkt meestal: '''uwgebruikersnaam:uwwachtwoord@sip.uwprovider.com/uwgebruikersnaam'''
  * Indien er verschillende nummers achter 1 gebruikersnaam hangen: '''uwgebruikersnaam:uwwachtwoord@sip.uwprovider.com/telefoonnummer'''
  * Soms kunt u het laatste deel weg laten: '''uwgebruikersnaam:uwwachtwoord@sip.uwprovider.com'''
 


 * Klik op ''apply settings''.
  
== SIP registratie status ==

Het is belangrijk om te controleren of de provider registratie succesvol is alvorens u verder kunt.

 * Installeer de FreePBX module: ''Asterisk info''
 * Ga naar ''Tools -> Asterisk info''
 * Klik op ''Registries''.
 * U ziet hier uw geconfigureerde SIP trunks. Het is erg belangrijk dat de state '''Registered''' is.

{{{
Host                            Username          Refresh State                Reg.Time                 
sip.uwprovider.com:5060         uwgebruikersnaam      105 Registered           Wed, 05 Oct 2011 16:40:46
}}}

Indien u een andere state ziet, heeft het geen zin om verder te gaan: Controleer de gegevens en neem eventueel contact op met uw provider of DatuX voor verdere hulp.


= Standaard taal op nederlands =

Om de bepaalde voice teksten zoals het voicemail menu in het nederlands te krijgen doet u het volgende:

 * Installeer de FreePBX module: ''Asterisk SIP settings''
 * Ga naar ''Tools -> Asterisk SIP settings''
 * Voer bij het veld ''language'' de tekst ''nl'' in.
 * ''Apply settings.''

Let op: nog niet alle teksten zijn helaas vertaald in het nederlands.