[sr-dev] git:master:14e82498: secsipid: docs for secsipid_get_url()

[Daniel-Constantin Mierla]

Module: kamailio
Branch: master
Commit: 14e82498f24dff5cf7ebd416e9bb88500583645b
URL: https://github.com/kamailio/kamailio/commit/14e82498f24dff5cf7ebd416e9bb88500583645b

Author: Daniel-Constantin Mierla <miconda at gmail.com>
Committer: Daniel-Constantin Mierla <miconda at gmail.com>
Date: 2020-11-17T11:45:06+01:00

secsipid: docs for secsipid_get_url()

---

Modified: src/modules/secsipid/doc/secsipid_admin.xml

---

Diff:  https://github.com/kamailio/kamailio/commit/14e82498f24dff5cf7ebd416e9bb88500583645b.diff
Patch: https://github.com/kamailio/kamailio/commit/14e82498f24dff5cf7ebd416e9bb88500583645b.patch

---

diff --git a/src/modules/secsipid/doc/secsipid_admin.xml b/src/modules/secsipid/doc/secsipid_admin.xml
index ecc9060ce3..878000efa5 100644
--- a/src/modules/secsipid/doc/secsipid_admin.xml
+++ b/src/modules/secsipid/doc/secsipid_admin.xml
@@ -207,11 +207,33 @@ request_route {
 ...
 </programlisting>
 		</example>
+	</section>
+	<section id="secsipid.f.secsipid_get_url">
+		<title>
+		<function moreinfo="none">secsipid_get_url(url, ovar)</function>
+		</title>
 		<para>
-			Further checks can be done with config operations, decoding the JWT header
-			and payload using {s.select} and {s.decode.base64t} transformations
-			together with jansson module.
+			Get the content of a URL and store the result in a variable.
+		</para>
+		<para>
+		The url parameters can contain pseudo-variables and ovar has to be
+		the name of a writtable pseudo-variable.
+		</para>
+		<para>
+		This function can be used from ANY_ROUTE.
 		</para>
+		<example>
+		<title><function>secsipid_get_url</function> usage</title>
+		<programlisting format="linespecific">
+...
+request_route {
+  ...
+  if(secsipid_get_url("https://$fd/stirshaken/cert.pem", "$var(pubkey)")) { ... }
+  ...
+}
+...
+</programlisting>
+		</example>
 	</section>
 	<section id="secsipid.f.secsipid_add_identity">
 		<title>