Merge pull request #17 from phillipkent/dev_add_urllib_safe_option
Add note in dev.rst about use of the safe option in urllib.quote_plus()
diff --git a/rtd/source/dev.rst b/rtd/source/dev.rst
index 66ef6b8..bdb6b3e 100644
--- a/rtd/source/dev.rst
+++ b/rtd/source/dev.rst
@@ -249,6 +249,11 @@
>>> request_str
'apikey=plgWJfZK4gyS3mOMTVmjUVg-X-jlWlnfaUJ9GAbBbf9EdM-kAYMmAiLqzzq1ElZLYq_u38zCm0bewzGUdP66mg&command=listUsers&response=json'
+.. note::
+ If you have API calls which contain * (asterisk) characters, you will need to add the option "safe = '*'" for the URL encoding.
+ The reason is that Python's urllib will encode * characters by default, while CloudStack's internal encoder does not encode them;
+ this results in an authentication failure for your API call. In the above you would replace "urllib.quote_plus(request[k])"
+ with "urllib.quote_plus(request[k], safe='*')".
Compute the signature with hmac, do a 64 bit encoding and a url
encoding: