summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndreas Schneider <asn@cryptomilk.org>2015-12-16 09:33:04 +0100
committerAndreas Schneider <asn@cryptomilk.org>2015-12-16 09:33:04 +0100
commitb97c2743f7acd3408f60bb5606c3fdfa7e34715f (patch)
treeceade74cebed7f035a799cb995954db530190f9d
parentf12ac14dc558b1929bc7209c7084c50d0d242083 (diff)
downloadcwrap_website-b97c2743f7acd3408f60bb5606c3fdfa7e34715f.tar.gz
cwrap_website-b97c2743f7acd3408f60bb5606c3fdfa7e34715f.tar.xz
cwrap_website-b97c2743f7acd3408f60bb5606c3fdfa7e34715f.zip
Add pam_wrapper subpage
-rw-r--r--img/pam_wrapper.pngbin0 -> 70151 bytes
-rw-r--r--pam_wrapper.html133
2 files changed, 133 insertions, 0 deletions
diff --git a/img/pam_wrapper.png b/img/pam_wrapper.png
new file mode 100644
index 0000000..f45b752
--- /dev/null
+++ b/img/pam_wrapper.png
Binary files differ
diff --git a/pam_wrapper.html b/pam_wrapper.html
new file mode 100644
index 0000000..2505e49
--- /dev/null
+++ b/pam_wrapper.html
@@ -0,0 +1,133 @@
+<!DOCTYPE html>
+<html lang="en"><head>
+<meta http-equiv="content-type" content="text/html; charset=UTF-8">
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+ <meta name="description" content="">
+ <meta name="author" content="">
+ <link rel="shortcut icon" href="/favicon.png">
+
+ <title>cwrap - pam_wrapper</title>
+
+ <!-- Bootstrap core CSS -->
+ <link href="assets/css/bootstrap.min.css" rel="stylesheet">
+
+ <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
+ <!--[if lt IE 9]>
+ <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
+ <script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
+ <![endif]-->
+ <link href="assets/cwrap.css" type="text/css" rel="stylesheet"></head>
+
+ <body>
+ <div class="container subpage-header">
+ <div class="">
+ <a href="/">cwrap</a>
+ </div>
+ </div>
+
+ <div class="container subpage">
+ <h1>The pam_wrapper library</h1>
+ <!-- Example row of columns -->
+ <div class="row">
+ <div class="col-md-12">
+ <p>A tool to test PAM applications and PAM modules</p>
+
+ <div align="center">
+ <img src="img/pam_wrapper.png" border="0"/>
+ </div>
+
+ <br />
+
+ <p align="center">
+ <a class="btn btn-warning btn-lg" role="button" href="./download.html#pam_wrapper"><span class="glyphicon glyphicon-random"></span> Clone with git</a> ยท
+ <a class="btn btn-danger btn-lg" role="button" href="https://bugzilla.samba.org/enter_bug.cgi?product=cwrap"><span class="glyphicon glyphicon-send"></span> Report a bug</a>
+ </p>
+
+ <br />
+
+ <p>
+ This component of cwrap allows you to either test your PAM
+ (Linux-PAM and OpenPAM) application or module. For testing PAM
+ applications we have written a simple PAM module called
+ pam_matrix (see below). If you plan to test a PAM module you
+ can use the pamtest library we have implemented. It simplifies
+ testing of modules. You can combine it with the
+ <a href="https://cwrap.org" target="_blank">cmocka unit testing framework</a>
+ or you can use the provided Python bindings to write tests for your module
+ in Python.
+ </p>
+
+ <h2>Features</h2>
+ <ul>
+ <li>Allows you test user logins in applications.</li>
+ <li>Simplfies testing of PAM modules.</li>
+ <li>Provides a C library and python bindings to write
+ simpler tests with less code</li>
+ </ul>
+
+ <h2>Detailed descriptions</h2>
+ <ul>
+ <li>If you load the pam_wrapper and enable it with setting
+ <code>PAM_WRAPPER=1</code> all PAM functions like
+ <code>pam_start()</code> and
+ <code>pam_authenticate()</code> calls will work, even as a
+ normal user.</li>
+ <li>You have to specify your directory with service files
+ using <code>PAM_WRAPPER_SERVICE_DIR</code>.</li>
+ <li>Enable debugging of pam_wrapper itself by setting the
+ <code>PAM_WRAPPER_DEBUGLEVEL</code> variable.</li>
+ </ul>
+
+ <h2>pam_matrix</h2>
+ <p>Testing PAM application often requires to set up an
+ authentication backend with as little effort as possible. The
+ pam_matrix module allows to authenticate against a key-value
+ text file, provided by an option or with an environment
+ variable.</p>
+
+ </div> <!-- /col -->
+ </div>
+
+ </div>
+ <div class="container footer-line">
+ <footer>
+ <div class="row footer">
+ <div class="col-md-6">
+ <h3>Contact</h3>
+ <p><a href="https://lists.samba.org/mailman/listinfo/samba-technical" target="_blank">samba-technical@lists.samba.org</a></p>
+ </div>
+
+ <div class="col-md-3 col-md-offset-3">
+ <h3>Credits</h3>
+ <p>Robin Hack<br />
+ Andreas Schneider</p>
+ </div>
+ </div>
+ </footer>
+ </div> <!-- /container -->
+
+ <!-- Bootstrap core JavaScript
+ ================================================== -->
+ <!-- Placed at the end of the document so the pages load faster -->
+ <script src="assets/js/jquery-1.js"></script>
+ <script src="assets/js/bootstrap.min.js"></script>
+
+<!-- Piwik -->
+<script type="text/javascript">
+ var _paq = _paq || [];
+ _paq.push(['trackPageView']);
+ _paq.push(['enableLinkTracking']);
+ (function() {
+ var u="//stats.cryptomilk.org/";
+ _paq.push(['setTrackerUrl', u+'piwik.php']);
+ _paq.push(['setSiteId', 3]);
+ var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
+ g.type='text/javascript'; g.async=true; g.defer=true; g.src=u+'piwik.js'; s.parentNode.insertBefore(g,s);
+ })();
+</script>
+<noscript><p><img src="//stats.cryptomilk.org/piwik.php?idsite=3" style="border:0;" alt="" /></p></noscript>
+<!-- End Piwik Code -->
+
+</body></html>