diff --git a/README.md b/README.md index 0527f1e..604cc7b 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,16 @@ Install [jq](https://stedolan.github.io/jq/download/). Add your login credentials to `login_credentials_muster.sh` and rename the file to `.env` +Since sipgate enforces 2FA, your usual username and password won't work anymore. +Now, you need a so-called [Personal Access Token](https://app.sipgate.com/w0/personal-access-token), that you can retrieve after you login to the web interface. +Enable at least the following scopes: +* balance:read +* devices:callerid:read +* devices:callerid:write +* history:read +* sessions:fax:write +Enter the token-ID as `SIPUSER` or `TOKENID` and the token as `SIPPWD` or `TOKEN`. + If you use Letterheads Address database, uncomment the last line of that file and add `your/path/to/Letterhead` ## Usage diff --git a/login_credentials_muster.sh b/login_credentials_muster.sh index d0ac3b4..8636a9d 100755 --- a/login_credentials_muster.sh +++ b/login_credentials_muster.sh @@ -1,5 +1,13 @@ -#Add your sipgate username and password here: -SIPUSER= -SIPPWD= +# Add your sipgate token-ID and token here: +# TOKENID is an alias for SIPUSER +# TOKEN is an alias for SIPPWD, +# so for legacy reasons you can use those variables as well. +# Take care: The SIP* variables MUST be empty/unset or contain the config to use. +# If they are set and not empty, the corresponding TOKEN* variable is ignored. +TOKENID= +TOKEN= #uncomment if you use Letterheads Address database #LETTERHEAD_PATH= +#Add your default CallerID here: +DEFAULT_CALLER_ID="anonymous" +LETTERHEAD_PATH="/home/bernhardt/Entwicklung/Letterhead"