[sr-dev] git:master:c5ca978b: secsipid: docs for secsipid_check_identity_pubkey()

[Daniel-Constantin Mierla]

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

Author: Daniel-Constantin Mierla <miconda at gmail.com>
Committer: Daniel-Constantin Mierla <miconda at gmail.com>
Date: 2020-11-17T10:16:55+01:00

secsipid: docs for secsipid_check_identity_pubkey()

---

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

---

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

---

diff --git a/src/modules/secsipid/doc/secsipid_admin.xml b/src/modules/secsipid/doc/secsipid_admin.xml
index 8f0a3d48db..ecc9060ce3 100644
--- a/src/modules/secsipid/doc/secsipid_admin.xml
+++ b/src/modules/secsipid/doc/secsipid_admin.xml
@@ -171,6 +171,40 @@ request_route {
     ...
 }
 ...
+</programlisting>
+		</example>
+		<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.
+		</para>
+	</section>
+	<section id="secsipid.f.secsipid_check_identity_pubkey">
+		<title>
+		<function moreinfo="none">secsipid_check_identity(pubkeyVal)</function>
+		</title>
+		<para>
+			Similar to secsipid_check_identity() with the public key value
+			provided in the parameter.
+		</para>
+		<para>
+		The parameters can contain pseudo-variables.
+		</para>
+		<para>
+		This function can be used from ANY_ROUTE.
+		</para>
+		<example>
+		<title><function>secsipid_check_identity_pubkey</function> usage</title>
+		<programlisting format="linespecific">
+...
+request_route {
+  ...
+  http_client_query("https://provider.com/stir-shaken/cert.pem", "$var(pubkey)");
+  ...
+  if(secsipid_check_identity_pubkey("$var(pubkey)")) { ... }
+  ...
+}
+...
 </programlisting>
 		</example>
 		<para>