Blink Cocoa

h1. Known Issues

h2. STUN is not supported

Blink does not interoperate with SIP service providers that require STUN for REGISTER. STUN is an obsolete broken standard that claimed  that it solved NAT traversal problem. More concrete, these providers require the use of public IP addresses in the Contact header by the end-points when they REGISTER or make outgoing SIP sessions. As most of the end-points are located behind a NAT-ted router and using a private IP address, the way to obtain a public IP address was by using a protocol named STUN, which was wrongly described in 2003 as a NAT traversal solution (this is IETF standard RFC3489). Years later in 2008, this standard has been rectified (in RFC5389) to explicitly say that it does not provide a reliable solution for the original purpose and it should not be used the way it was originally thought. Using STUN is unreliable because it depends on the way the NAT routers are implemented, which is not standardized nor can be probed and guessing the IP address and port used for outbound connections was not working deterministically. Also, it is unsecure behaviour for a server to trust an IP address expressed in a header by a client. The new version of the STUN protocol defined in RFC 5389 explains in which context STUN may be used and advises against the use of STUN as a standalone NAT traversal utility, quote from the standard:

*Experience since the publication of RFC 3489 has found that classic STUN simply does not work sufficiently well to be a deployable solution.*

Unfortunately, some SIP service providers have not updated their implementations to fix this issue, which implies using a simple technique that is using for replies the actual IP and port where the packets originate from rather than using the ones presented in the Contact header. Blink was developed in 2009. Implementing a broken standard from 2003 which was deprecated in 2008 was not considered and is not on the roadmap.

h2. Right click on Contacts does not work always

Affected versions: Blink Pro 2.0.0 and Blink Lite 2.0.0

Replace for Blink Pro

<pre>

/Applications/Blink\ Pro.app/Contents/Resources/ContactWindowController.py

</pre>

or for Blink Lite

<pre>

/Applications/Blink\ Lite.app/Contents/Resources/ContactWindowController.py

</pre>

with this one:

http://download.ag-projects.com/Blink/2.0.0/ContactWindowController.py

To access the application folder right click on it in finder and select Show Package Contents from the contextual menu.

h2. Sometimes incoming calls are rejected with 488

Affected versions: Blink Pro 2.0.0 and Blink Lite 2.0.0

Replace for Blink Pro

<pre>

/Applications/Blink\ Pro.app/Contents/Resources/lib/sipsimple/streams/rtp.py

</pre>

or for Blink Lite

<pre>

/Applications/Blink\ Lite.app/Contents/Resources/lib/sipsimple/streams/rtp.py

</pre>

with this one:

http://download.ag-projects.com/Blink/2.0.0/rtp.py

To access the application folder right click on it in finder and select Show Package Contents from the contextual menu.

h2. Enrollment for free sip account failure may cause crash

Affected versions: Blink Pro < 2.0 and Blink Lite < 2.0

Replace

<pre>

/Applications/Blink\ Pro.app/Contents/Resources/EnrollmentController.py

</pre>

and / or

<pre>

/Applications/Blink\ Lite.app/Contents/Resources/EnrollmentController.py

</pre>

with this one:

http://download.ag-projects.com/Blink/Pro-1.9.0/EnrollmentController.py

Then restart Blink and register the sip account that failed again.

h2. Single quote character in account display name configuration (config file gets corrupted)

Replace

<pre>

/Applications/Blink\ Pro.app/Contents/Resources/lib/sipsimple/configuration/backend/file.py

</pre>

with this one:

http://download.ag-projects.com/Blink/Pro-1.9.0/file.py

h2. Add contact fails (Blink Pro 1.9.0)

A fix is available in 1.9.1 currently in Apple review queue. You can fix this manually by replacing the following file:

<pre>

/Applications/Blink Pro.app/Contents/Resources/ContactWindowController.py

</pre>

with this one:

http://download.ag-projects.com/Blink/Pro-1.9.0/ContactWindowController.py

To locate the file right, click in Finder on Blink Pro and click on Show Package Contents option.

Then restart Blink.

h2. Add contact fails (Blink Lite 1.7.0)

A fix is available in 1.7.1 currently in Apple review queue. You can fix this manually by replacing the following file:

<pre>

/Applications/Blink Lite.app/Contents/Resources/ContactWindowController.py

</pre>

with this one:

http://download.ag-projects.com/Blink/Lite-1.7.0/ContactWindowController.py

To locate the file right, click in Finder on Blink Lite and click on Show Package Contents option.

Then restart Blink.

h2. Migration panel does not vanish (Blink Pro 1.8.3)

Fixed in newer versions.

Replace the following file:

<pre>

/Applications/Blink Pro.app/Contents/Resources/HistoryManager.py

</pre>

with this one:

http://download.ag-projects.com/Blink/HistoryManager.py

To locate the file right, click in Finder on Blink Pro and click on Show Package Contents option.

Then restart Blink.