SIP koppeling aan SpeakUp via Switch
SpeakUp gebruikt het SIP protocol om verschillende centrales aan elkaar te koppelen. In dit document wordt uitgelegd hoe deze koppeling kan worden opgezet. Deze handleiding is uitsluitend bedoeld voor centrales met een vast publiek IP adres. Voor overige mogelijkheden, zie connecties.
Proxies
SpeakUp heeft meerdere SIP proxies waaraan gekoppeld kan worden. Deze zijn via DNS d.m.v. SRV records te vinden. Hierdoor wordt automatisch in een failover scenario voorzien. Als hostname voor de proxy moet switch.sip.speakup.nl gebruikt worden.
Indien uw platform geen SRV records ondersteunt, zal switch.sip.speakup.nl meerdere A records teruggeven. Of hierbij ook failover optreedt bij het onbereikbaar zijn van 1 van de proxies is afhankelijk van uw platform. Evenueel kunt u ook switch1.sip.speakup.nl en switch2.sip.speakup.nl gebruiken.
Voor systemen die SRV records ondersteunen en systemen die met
maximaal 1 proxy kunnen communiceren:
switch.sip.speakup.nl
Voor systemen die geen SRV records ondersteunen, maar wel met meerdere
proxies kunnen communiceren (t.b.v. fail-over en/of load-balancing):
switch1.sip.speakup.nl
switch2.sip.speakup.nl
Uitgaande gesprekken kunnen naar elke proxy worden gerouteerd en inkomende gesprekken kunnen vanaf elke proxy binnenkomen. Belangrijk is dat de RTP data (audio signaal) vanaf (en naar) elk systeem binnen en buiten het SpeakUp netwerk kan komen (en gaan). Een eventuele firewall moet hierop voorbereid zijn.
Inkomende gesprekken
Om inkomende gesprekken naar uw centrale te routeren hebben we een host- of domeinnaam (of ip-adres) nodig waar de centrale te bereiken is. Zolang dit niet aan SpeakUp is doorgegeven is uitsluitend uitbellen mogelijk.
Authenticatie
Voor het ontvangen van oproepen dient u inkomend verkeer van onze SIP-proxies te accepteren (IP-based). Voor uitgaande gesprekken moet u authenticeren met een gebruikersnaam/wachtwoordcombinatie die door SpeakUp wordt toegestuurd. Indien dit op uw platform niet mogelijk is, kunnen we (op eigen risico) ook op IP basis verkeer doorlaten.
Bellen
SpeakUp gebruikt voor nummers het ITU-international of e.164 formaat. Om bijvoorbeeld SpeakUp te bellen (088-7732587), moet het nummer +31887732587 gebeld worden. Indien dit voor u handiger is wordt ook verkeer met 0 of 00 geaccepteerd, waarbij 0 als Nederland-nationaal wordt gezien. Wanneer het CallerID een Nederlands netnummer is, is het ook mogelijk verkort te kiezen binnen uw netnummerregio. Binnen Enschede, met een 3153... CallerID is het dus mogelijk 31532345678 te kiezen door 2345678 te sturen.
Uitgaande gesprekken moeten altijd voorzien zijn van een geldig CallerID nummer (in e.164 formaat). Dit wil zeggen dat het CallerID-nummer één van de aan het account toegewezen nummers moet zijn. Indien er geen of een ongeldig CallerID-nummer wordt meegestuurd, reageert onze switch met het een "503 Invalid CallerID" (hetgeen door Asterisk als Congestion signaal wordt geïnterpreteerd). De CallerID-naam mag willekeurig zijn.
Nummeronderdrukking
Nummeronderdrukking wordt op 2 manieren ondersteund:
- Voor recente (sinds ca. 2003) SIP applicaties die de diverse SIP standaarden ondersteunen wordt rfc3325 (gedeeltelijk) ondersteund.
- In de header "P-Preferred-Identity" moet een geldig CallerID worden opgegeven (als SIP-uri)
- De header "Privacy" moet de waarde id bevatten
- In de "From" header mag nu iets anoniems staan, bij voorkeur "Anonymous <anonymous@anonymous.invalid>"
- Let op dat de From ongewijzigd doorgegeven wordt bij gebruik van rfc3325.
Voorbeeld:
From: Anonymous <anonymous@anonymous.invalid>
P-Preferred-Identity: SpeakUp <1234567890@speakup.nl>
Privacy: id
- Voor applicaties die dit niet ondersteunen kunt u door naast een geldig CallerID-nummer in de From username als "Display Name" de waarde 'Anonymous' te gebruiken.
Voorbeeld:
From: Anonymous <1234567890@speakup.nl>
(Nummeronderdrukking bieden we aan op 'best-effort' basis, we kunnen hier geen garanties op geven)
- Op het moment dat de P-Preferred-Identity header aanwezig is in de request, wordt er van uitgegaan dat rfc3325 ondersteund wordt. Andere methoden voor nummeronderdrukking vervallen dan.
Voorbeeldconfiguraties
In onze Knowledge Base vind je configuratievoorbeelden, zoals bijvoorbeeld voor Asterisk