PermissionsUse

As security is important stuff on mobile system, Android has a permissions system. It's up to users to be really careful with what permission he grant to an application.

You have no big fear to have with CSipSimple cause it's an opensource application and you can read the code in the Source tab here and ensure that nothing bad is done with your private datas.

But as most users may not have skills to read java and C code, this page is here to explain what permissions are used by CSipSimple and why it use these permissions.

Permissions used by CSipSimple

INTERNET

Obviously as SIP application has to communicate with your SIP server it requires permission to access the network. Be careful if you have a limited 3G data plan and don't want CSipSimple to use your 3G connection to communicate with your server to left "I'm allowed to Use mobile data" deactivated. CSipSimple may also do some network traffic when you use a wizard with balance inquiry feature (such as ippi and betamax clones). But that's done only when you go in the wizard. It also use network for the FAQ that is hosted on this website.

RECORD_AUDIO

It's useful to allow remote party to hear you ;)

MODIFY_AUDIO_SETTINGS

WRITE_SETTINGS

It allow CSipSimple to change audio routing. For example routing to earpiece/rear speaker. It also allow CSipSimple to put the phone in silent/vibrate mode while in SIP call if an incoming GSM call arrives. If I do not your hear may explode if there is an incoming GSM call that ring !

PROCESS_OUTGOING_CALLS

It allows the application to integrate android when an outgoing call is made. And propose you a popup that allows you to choose between a SIP account and GSM. If you disable the feature in CSipSimple to "Integrate dialer" it will not process outgoing calls and just leave the standard telephony application manage it.

READ_PHONE_STATE

Even if not properly managed yet it will allow the application to be aware about the fact there is an ongoing/incoming GSM call and so do what should be done for your SIP calls.

ACCESS_WIFI_STATE

ACCESS_NETWORK_STATE

It allows the application to know about the fact you are using wifi / mobile data and so act regarding that (register/do not register, allow you to place sip calls or not).

RECEIVE_BOOT_COMPLETED

With this permission the app should be able to automatically start. Don't be afraid, it does not mean that the app will be running in background. And by running I mean doing something : many users confuse with an app running and an active process app. Android manage a clever way your phone memory in recent android versions. As consequence an app can be listed by task managers but actually do nothing and so consume no battery. So if CSipSimple is properly configured it should not be hurting to register at autostart. It will auto stop itself (auto stop doesn't mean kill but regarding resources consumptions it is the same).

READ_CONTACTS

Allow contact integration within the application. Also allow to show contact picture and ringtone when there is an incoming call.

WRITE_CONTACTS

Allows to update SIP presence information. Also allow to write in your favorites a "csip" uri when you set the information to use for the favorite group as SIP data.

CALL_PHONE

This is useful for GSM dialer integration. If call is not treat by CSipSimple it forward the request to the GSM dialer. Also be careful, by default CSipSimple user interface allow you to use mobile calls directly from its user interface. Check the little icon on the top right ;). There is a setting to prevent the use of GSM calls in CSipSimple interface that you can configure in settings.

CALL_PRIVILEGED

For android 2.3 sip integration and android 4.0 tel integration in case the application is distributed as part of a ROM distribution. It should normally not be granted by android when distributed as third party application and not be used by the application in this case.

WAKE_LOCK

Allow CSipSimple to acquire wake locks when in call or when setup to do so when registered. Wake lock allows the application to ask CPU to stay active or to ask screen to stay enlighten. It's used only when necessary and is often configurable.

DISABLE_KEYGUARD

Allow the application to remove keyguard when the phone is in keylock mode. With this permission csipsimple is able to wakeup the phone and disable keyguard while you are in call or received an incoming call. It will reactivate keyguard when call is finished.

VIBRATE

For vibrate ringing mode and for dialer feedback.

BLUETOOTH

For using bluetooth device. There is still known problems to use fully Bluetooth SCO as implementation and what is allowed by manufacturers depends from a device to another.

READ_LOGS

It is useful for the embedded issue reporting tool. CSipSimple use the standard logging system to write logs. To get back logs and send it to developers, it requires the permission to read logs. It's interesting for us to get the entire logs cause we can get some interesting logs about the audio driver of the phone for example. Or logs from network stack. If you don't use embedded issue reporting tool this permission will not be used by the application.

WRITE_EXTERNAL_STORAGE

Used to write audio records on SDCard, to write backups and logs.

CAMERA

The application is now ready to host the video plugin available for now for alpha testers here. If you don't install the video plugin, this permission will not be used.

BROADCAST_STICKY

Due to a "bug" in android 4.0 the connection to bluetooth system was requiring this permission (which broke releases 0.03-xx on android 4.0. In order to be compatible with android 4.0 and to be able to connect Bluetooth SCO we need this permission. If you don't use bluetooth the permission will not be used.

READ_PROFILE

This permission is only required to be able to get your own photo/picture and display it in the user interface of the SIP Messaging feature. It's never used elsewhere. Besides this feature only works for android > 3.x (was not possible before). So if you are using android before 3.x you'll not see your own photo in the messaging interface.

WRITE_CALL_LOG

Introduced in android 4.1 this permission is used to be able to integrate CSipSimple call logs to stock call logs. There is an option in CSipSimple settings to disable call log integration if you don't want the application to use this feature.

USE_SIP

CONFIGURE_SIP

This is mostly for internal use. CSipSimple may provide other application to control SIP calls and messages and also SIP configuration. To restrict rights of other apps to do that. There is these two rights. Besides USE_SIP is also the permission used by the stock SIP application. As consequence for the future it will allow CSipSimple to use the stock SIP stack in addition to pjsip stack.

Permissions provided by CSipSimple

CSipSimple may provide other apps a way to automatically configure your accounts or to override the calls screen or to place SIP calls. To restrict the numbers of applications allowed to do that, it announce permission that for which other apps should have grants if they wants to use SIP service. These permissions are : Use SIP (for make calls and control calls) and Configure SIP for read/write access to your sip datas (account configuration/sip call logs/sip messages...).

So be careful with the apps you grant these permissions. By allowing an application to use some permission on android you trust the application. Do not trust anybody ;).

[Anonymous]

Originally posted by: redwood...@gmail.com

I installed csip and it appears to be working with one exception, it shows its dialing but the call never goes thru, please advise.

Thanks!

[Anonymous]

Originally posted by: jimmywen...@gmail.com

hello,

When I make calls and try to hang up or end the call, using the END button, it does not work, could you please help with this matter.

thanks!!

[Anonymous]

Originally posted by: roger.bo...@ac-bordeaux.fr

Bonjour, Sur mon Smartphone Android, j’ai configuré media5 fone pour Libertalk de SFR mais pour pouvoir utiliser les bornes SFR font Wifi il faut configurer en mode Tunnel, comment faire ? Mercio d’avance

[Anonymous]

Originally posted by: arl...@hotmail.com

thanks.

[Anonymous]

Originally posted by: johnson.sherri6975

Please send vpn support for Samsung Galaxy S II D710. Thanks.

[Anonymous]

Originally posted by: arulogun...@gmail.com

Good project. keep it up. How to contribute/support the project?

[Anonymous]

Originally posted by: noorisad...@gmail.com

I dont ip address. Help me please

[Anonymous]

Originally posted by: ylyllamb...@gmail.com

Bonjour, je voudrais modifier le port SIP 5060 à 5962. Comment faire ? Merci.

[Anonymous]

Originally posted by: m.alibo...@googlemail.com

i have installed SIP i.e wimessenger and it is not asking me to call from wimessenger or from mobile it is just calling from my mobie. what to do please suggest.

[Anonymous]

Originally posted by: tfrancoi...@gmail.com

my number is not work

[Anonymous]

Originally posted by: quiqinfo...@gmail.com

This is good app every one can edit and understand how android c based sip client working through NAT . I have a one question which codec really using opus or silk ARM or under pjsip?

[Anonymous]

Originally posted by: jofrei...@gmail.com

jofrei269@gmail.com tanks merci Obrigado

[Anonymous]

Originally posted by: encraoud...@gmail.com

Lollipop widget is not working here (Nexus 4 / FreePhonie?).

[Anonymous]

Originally posted by: williego...@gmail.com

I got "603 / denied" error what does it mean? what can I do to fix it? I really need to call to a cellphone in russia but this app is not letting me do it, I have my ONSIP account configured into the app but doesnot work well, only to call other ONSIP users but not cellphones... Please help or give me any answer to this so I can dump this app or still using it!