This file is indexed.

/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 &mdash; 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> &raquo;</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">&gt;&gt;&gt; </span><span class="n">pskc</span> <span class="o">=</span> <span class="n">PSKC</span><span class="p">(</span><span class="s">&#39;somefile.pskcxml&#39;</span><span class="p">)</span>
<span class="gp">&gt;&gt;&gt; </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">&#39;qwerty&#39;</span><span class="p">)</span>
<span class="gp">&gt;&gt;&gt; </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">&#39;http://www.w3.org/2000/09/xmldsig#hmac-sha1&#39;</span>
<span class="gp">&gt;&gt;&gt; </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> &raquo;</li> 
      </ul>
    </div>
    <div class="footer">
        &copy; 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>