/usr/share/doc/python-pskc/html/mac.html is in python-pskc 0.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Integrity checking — python-pskc 0.2 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '0.2',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="python-pskc 0.2 documentation" href="index.html" />
<link rel="next" title="Key usage policy" href="policy.html" />
<link rel="prev" title="PSKC encryption" href="encryption.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="policy.html" title="Key usage policy"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="encryption.html" title="PSKC encryption"
accesskey="P">previous</a> |</li>
<li><a href="index.html">python-pskc 0.2 documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="module-pskc.mac">
<span id="integrity-checking"></span><h1>Integrity checking<a class="headerlink" href="#module-pskc.mac" title="Permalink to this headline">¶</a></h1>
<p>The PSKC format allows for <a class="reference external" href="https://tools.ietf.org/html/rfc6030#section-6.1.1">message authentication and integrity checking</a> for some of the values
stored within the PSKC file.</p>
<dl class="class">
<dt id="pskc.mac.MAC">
<em class="property">class </em><tt class="descclassname">pskc.mac.</tt><tt class="descname">MAC</tt><a class="headerlink" href="#pskc.mac.MAC" title="Permalink to this definition">¶</a></dt>
<dd><dl class="attribute">
<dt id="pskc.mac.MAC.algorithm">
<tt class="descname">algorithm</tt><a class="headerlink" href="#pskc.mac.MAC.algorithm" title="Permalink to this definition">¶</a></dt>
<dd><p>The name of the MAC algorithm to use (currently <tt class="docutils literal"><span class="pre">HMAC-MD5</span></tt>,
<tt class="docutils literal"><span class="pre">HMAC-SHA1</span></tt>, <tt class="docutils literal"><span class="pre">HMAC-SHA224</span></tt>, <tt class="docutils literal"><span class="pre">HMAC-SHA256</span></tt>, <tt class="docutils literal"><span class="pre">HMAC-SHA384</span></tt> and
<tt class="docutils literal"><span class="pre">HMAC-SHA512</span></tt> are supported).</p>
</dd></dl>
<dl class="attribute">
<dt id="pskc.mac.MAC.key">
<tt class="descname">key</tt><a class="headerlink" href="#pskc.mac.MAC.key" title="Permalink to this definition">¶</a></dt>
<dd><p>For HMAC checking, this contains the binary value of the MAC key. The
MAC key is generated specifically for each PSKC file and encrypted with
the PSKC encryption key, so the PSKC file should be decrypted first
(see <a class="reference internal" href="encryption.html"><em>PSKC encryption</em></a>).</p>
</dd></dl>
</dd></dl>
<p>Once the PSKC encryption key has been set up key values can be explicitly
checked using the <a class="reference internal" href="usage.html#pskc.key.Key.check" title="pskc.key.Key.check"><tt class="xref py py-func docutils literal"><span class="pre">check()</span></tt></a> method:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">pskc</span> <span class="o">=</span> <span class="n">PSKC</span><span class="p">(</span><span class="s">'somefile.pskcxml'</span><span class="p">)</span>
<span class="gp">>>> </span><span class="n">pskc</span><span class="o">.</span><span class="n">encryption</span><span class="o">.</span><span class="n">derive_key</span><span class="p">(</span><span class="s">'qwerty'</span><span class="p">)</span>
<span class="gp">>>> </span><span class="n">pskc</span><span class="o">.</span><span class="n">mac</span><span class="o">.</span><span class="n">algorithm</span>
<span class="go">'http://www.w3.org/2000/09/xmldsig#hmac-sha1'</span>
<span class="gp">>>> </span><span class="nb">all</span><span class="p">(</span><span class="n">key</span><span class="o">.</span><span class="n">check</span><span class="p">()</span> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">pskc</span><span class="o">.</span><span class="n">keys</span><span class="p">)</span>
<span class="go">True</span>
</pre></div>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="encryption.html"
title="previous chapter">PSKC encryption</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="policy.html"
title="next chapter">Key usage policy</a></p>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="policy.html" title="Key usage policy"
>next</a> |</li>
<li class="right" >
<a href="encryption.html" title="PSKC encryption"
>previous</a> |</li>
<li><a href="index.html">python-pskc 0.2 documentation</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2014, Arthur de Jong.
Last updated on Jun 20, 2014.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
</div>
</body>
</html>
|