Difference between revisions of "Authentication"
(One intermediate revision by one user not shown) | |||
Line 4: | Line 4: | ||
Every function of the SOAP API that requires authentication must pass in Authentication Parameters. To acquire a set of Authentication Parameters, please use the API found at: http://api.upsidewireless.com/soap/Authentication.asmx. | Every function of the SOAP API that requires authentication must pass in Authentication Parameters. To acquire a set of Authentication Parameters, please use the API found at: http://api.upsidewireless.com/soap/Authentication.asmx. | ||
− | Token and Signature, two values that are returned from the function are then used for every subsequent call to the API. They are used as proxies for your username and password as some users prefer to use the non-SSL | + | Token and Signature, two values that are returned from the function are then used for every subsequent call to the API. They are used as proxies for your username and password as some users prefer to use the non-SSL option for function calls, in which case, calls made to the API are sent over the Internet unencrypted. The use of proxies prevents unauthorized access to your [http://reseller.upsidewireless.com/ Upside Wireless] account. |
+ | |||
+ | The Token parameter will never change for the life of the account whereas the Signature will change if your password changes. | ||
+ | |||
+ | '''WARNING (NOT THE USUAL YADDA, YADDA):''' | ||
+ | * If you change your password in your on-line account, you must visit [[http://api.upsidewireless.com/soap/Authentication.asmx http://api.upsidewireless.com/soap/Authentication.asmx]] to have token/signature re-issued. | ||
+ | * Your application should store token/signature in a local store, instead of getting them before each sending or other action. Excessive calls to GetParameters function will cause your IP address to be blocked. | ||
− | |||
Latest revision as of 09:08, 29 October 2011
Authentication
Every function of the SOAP API that requires authentication must pass in Authentication Parameters. To acquire a set of Authentication Parameters, please use the API found at: http://api.upsidewireless.com/soap/Authentication.asmx.
Token and Signature, two values that are returned from the function are then used for every subsequent call to the API. They are used as proxies for your username and password as some users prefer to use the non-SSL option for function calls, in which case, calls made to the API are sent over the Internet unencrypted. The use of proxies prevents unauthorized access to your Upside Wireless account.
The Token parameter will never change for the life of the account whereas the Signature will change if your password changes.
WARNING (NOT THE USUAL YADDA, YADDA):
- If you change your password in your on-line account, you must visit [http://api.upsidewireless.com/soap/Authentication.asmx] to have token/signature re-issued.
- Your application should store token/signature in a local store, instead of getting them before each sending or other action. Excessive calls to GetParameters function will cause your IP address to be blocked.