From 35a6b056db84d38e47389888497faadfadea579a Mon Sep 17 00:00:00 2001
From: Tom Scavo <trscavo@internet2.edu>
Date: Sat, 10 Dec 2016 17:28:01 -0500
Subject: [PATCH] Document probe_saml_idp.sh

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index 0f3b62c..0745f15 100644
--- a/README.md
+++ b/README.md
@@ -39,6 +39,8 @@ saml_tools.sh
 
 ## Overview
 
+### ``cget.sh``
+
 Bash script ``cget.sh`` retrieves and caches HTTP resources on disk. A previously cached resource is retrieved via HTTP Conditional GET [RFC 7232]. If the web server responds with HTTP 200 OK, the resource is cached and written to stdout. If the web server responds with 304 Not Modified, the cached resource is output instead.
 
 To illustrate, define a couple of HTTP resources and a cache:
@@ -107,6 +109,20 @@ See the inline help file for details:
 $ $BIN_DIR/cget.sh -h
 ```
 
+### ``probe_saml_idp.sh``
+
+```Shell
+$ export SAML2_SP_ENTITY_ID=https://fm.incommon.org/sp
+$ export SAML2_SP_ACS_URL=https://service1.internet2.edu/Shibboleth.sso/SAML2/POST
+$ export SAML2_SP_ACS_BINDING=urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST
+$ mdq_base_url=http://mdq-beta.incommon.org/global
+$ id=urn:mace:incommon:internet2.edu
+$ $BIN_DIR/probe_saml_idp.sh -u $mdq_base_url $id
+0 redirects:3;response:200;dns:0.005;tcp:0.031;ssl:0.202;total:0.543 https://origin.internet2.edu/idp/profile/SAML2/Redirect/SSO urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect urn:mace:incommon:internet2.edu https://incommon.org
+0 redirects:3;response:200;dns:0.005;tcp:0.033;ssl:0.195;total:0.519 https://origin.internet2.edu/idp/profile/SAML2/POST/SSO urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST urn:mace:incommon:internet2.edu https://incommon.org
+0 redirects:3;response:200;dns:0.005;tcp:0.031;ssl:0.191;total:0.508 https://origin.internet2.edu/idp/profile/SAML2/POST-SimpleSign/SSO urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST-SimpleSign urn:mace:incommon:internet2.edu https://incommon.org
+```
+
 ## Compatibility
 
 Shell scripts are compatible with both GNU/Linux and Mac OS. XSLT scripts are written in XSLT 1.0.