ace-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r814419 - in /websites/staging/ace/trunk/content: ./ dev-doc/design/auditlog-protocol.html
Date Wed, 25 Apr 2012 15:55:35 GMT
Author: buildbot
Date: Wed Apr 25 15:55:34 2012
New Revision: 814419

Log:
Staging update by buildbot for ace

Added:
    websites/staging/ace/trunk/content/dev-doc/design/auditlog-protocol.html
Modified:
    websites/staging/ace/trunk/content/   (props changed)

Propchange: websites/staging/ace/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Apr 25 15:55:34 2012
@@ -1 +1 @@
-1330285
+1330368

Added: websites/staging/ace/trunk/content/dev-doc/design/auditlog-protocol.html
==============================================================================
--- websites/staging/ace/trunk/content/dev-doc/design/auditlog-protocol.html (added)
+++ websites/staging/ace/trunk/content/dev-doc/design/auditlog-protocol.html Wed Apr 25 15:55:34
2012
@@ -0,0 +1,197 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+  <head>
+    <title>Audit Log Protocol</title>
+
+    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+    <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+
+    <link rel="stylesheet/less" type="text/css" href="/lib/bootstrap.less">
+    <link href="/css/prettify.css" rel="stylesheet">
+	<link href="/css/code.css" rel="stylesheet" media="screen">
+    <script src="/js/less-1.2.1.min.js" type="text/javascript"></script>
+    <script src="http://code.jquery.com/jquery-1.7.min.js"></script>
+    <script src="/js/prettify.js"></script>
+    
+    <script src="/js/bootstrap-alert.js"></script>
+    <script src="/js/bootstrap-dropdown.js"></script>
+    <script src="/js/bootstrap-tooltip.js"></script>
+    <script src="/js/bootstrap-alerts.js"></script>
+    <script src="/js/bootstrap-modal.js"></script>
+    <script src="/js/bootstrap-transition.js"></script>
+    <script src="/js/bootstrap-button.js"></script>
+    <script src="/js/bootstrap-popover.js"></script>
+    <script src="/js/bootstrap-twipsy.js"></script>
+    <script src="/js/bootstrap-buttons.js"></script>
+    <script src="/js/bootstrap-scrollspy.js"></script>
+    <script src="/js/bootstrap-typeahead.js"></script>
+    <script src="/js/bootstrap-carousel.js"></script>
+    <script src="/js/bootstrap-tab.js"></script>
+    <script src="/js/bootstrap-collapse.js"></script>
+    <script src="/js/bootstrap-tabs.js"></script>
+    
+    
+    
+    <script>
+    $(function () { prettyPrint() })
+    $().dropdown()
+    </script>
+  </head>
+
+  <body style="padding-top: 50px;">
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/index.html">Apache ACE</a>
+          <ul class="nav">
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">News <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/news.html">News</a>
+      </li>
+      <li>
+        <a href="/on-the-web.html">On the web</a>
+      </li>
+    </ul>
+  </li>
+  <li>
+    <a href="/downloads.html">Downloads</a>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">User Documentation <b
class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/user-doc/introduction.html">Introduction</a>
+      </li>
+      <li>
+        <a href="/user-doc/getting-started.html">Getting Started</a>
+      </li>
+      <li>
+        <a href="/user-doc/features.html">Features</a>
+      </li>
+      <li>
+        <a href="/user-doc/faq.html">FAQ</a>
+      </li>
+      <li>
+        <a href="/user-doc/support.html">Support</a>
+      </li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Developer Documentation
<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/dev-doc/requirements/">Requirements</a>
+      </li>
+      <li>
+        <a href="/dev-doc/architecture.html">Architecture</a>
+      </li>
+      <li>
+        <a href="/dev-doc/analysis/">Analysis</a>
+      </li>
+      <li>
+        <a href="/dev-doc/design/">Design</a>
+      </li>
+      <li>
+        <a href="/dev-doc/coding-standards.html">Coding Standards</a>
+      </li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Get Involved <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/get-involved/mailing-lists.html">Mailing Lists</a>
+      </li>
+      <li>
+        <a href="/get-involved/issue-tracking.html">Issue Tracking</a>
+      </li>
+      <li>
+        <a href="/get-involved/source-code.html">Source Code</a>
+      </li>
+      <li>
+        <a href="/get-involved/project-team.html">Project Team</a>
+      </li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Wiki <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="https://cwiki.apache.org/confluence/display/ACE/Board+Reports">Board
Reports <i class="icon-share-alt"></i></a>
+      </li>
+      <li>
+        <a href="https://cwiki.apache.org/confluence/display/ACE/Index">Homepage <i
class="icon-share-alt"></i></a>
+      </li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="http://www.apache.org/licenses/">Licenses <i class="icon-share-alt"></i></a>
+      </li>
+      <li>
+        <a href="http://www.apache.org/security/">Security <i class="icon-share-alt"></i></a>
+      </li>
+      <li>
+        <a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship <i
class="icon-share-alt"></i></a>
+      </li>
+      <li>
+        <a href="http://www.apache.org/foundation/thanks.html">Thanks <i class="icon-share-alt"></i></a>
+      </li>
+    </ul>
+  </li>
+</ul>
+
+        </div>
+      </div>
+    </div>
+    <div class="container">
+      <p><a href="/"><i class='icon-home'></i> Home</a>&nbsp;&raquo&nbsp;<a
href="/dev-doc/">Dev-doc</a>&nbsp;&raquo&nbsp;<a href="/dev-doc/design/">Design</a></p>
+      <h1>Audit Log Protocol</h1>
+      <div class="clear"></div>
+      <div id="content"><p>Audit logs record life cycle changes on targets. As
such, an audit log can be used to see changes over time and track what is actually on a target.
This design describes the protocol to exchange audit log information.</p>
+<p>Each target has an audit log. If the log somehow gets lost on the target, it will
generate a new log with a new unique ID. A log contains entries, where each entry gets a sequence
number.</p>
+<h1 id="protocol">Protocol</h1>
+<p>The audit log protocol consists of three commands. The first command can be used
for two parties to exchange information about available audit log entry sequence numbers.
The other two commands allow you to send and receive data.</p>
+<h1 id="querying-log-information">Querying log information</h1>
+<p>This command can be used to exchange information about available audit log entry
sequence numbers. Information is exchanged between either a target and a (relay) server, or
a relay server and a server. You ask the other party what sequence numbers it has, either
for a specific target or for all targets. The result is a collection of sequence numbers.
You can then act on that, sending the other party the entries it's missing and asking for
entries you don't have.</p>
+<ul>
+<li><code>GET auditlog/query</code> - returns a full list of sequence numbers</li>
+<li><code>GET auditlog/query?gwid=myid&amp;logid=2007-07-01</code>
- returns sequence numbers for a specific target</li>
+<li><code>GET auditlog/query?filter=(vendor='luminis')</code> - returns
sequence numbers for any target that matches the filter</li>
+</ul>
+<h3 id="about-queries">About queries</h3>
+<p>Queries (for log information or entries) come in three forms:</p>
+<ol>
+<li>Without any filter, you simply get everything.</li>
+<li>With a filter on certain keys, all values of specified keys will have to match.</li>
+<li>With an LDAP filter, where you can filter on arbitrary keys and use compound expressions
and pattern matching.</li>
+</ol>
+<h1 id="sending-log-information">Sending log information</h1>
+<p>By sending log information, you're pushing it to the other party. You will probably
first have figured out, by querying, what data actually needs to be sent.</p>
+<ul>
+<li>POST auditlog/send - returns status (ok, not ok)</li>
+</ul>
+<p>The data gets sent in the following format:</p>
+<div class="codehilite"><pre><span class="n">gwid</span><span
class="p">,</span> <span class="n">logid</span><span class="p">,</span>
<span class="n">seqnr</span><span class="p">,</span> <span class="n">eventnumber</span><span
class="p">,</span> <span class="n">type</span> <span class="p">(,</span>
<span class="n">key</span><span class="p">,</span> <span class="n">value</span><span
class="p">)</span><span class="o">*</span>
+</pre></div>
+
+
+<p>Data is terminated by '\n' (a new-line).</p>
+<h1 id="receiving-log-information">Receiving log information</h1>
+<p>Here you're asking the other party for data. As part of the request, you can ask
for specific information about one or more targets. If you're not specific, you will get everything.</p>
+<ul>
+<li><code>GET auditlog/receive</code> - returns list/collection of elements</li>
+<li><code>GET auditlog/receive?gwid=myid</code> - (see querying)</li>
+<li><code>GET auditlog/receive?filter=(region='asia')</code> - ...</li>
+</ul></div>
+      <hr>
+      <footer>
+        <p>Copyright &#169; 2012 <a href="http://www.apache.org/">The Apache
Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
License, Version 2.0</a>.<br/>Apache ACE, the Apache ACE logo, Apache and the
Apache feather logo are trademarks of The Apache Software Foundation. All other marks mentioned
may be trademarks or registered trademarks of their respective owners.</p>
+      </footer>
+    </div>
+  </body>
+</html>



Mime
View raw message