mirror of https://github.com/MISP/MISP
75 lines
4.0 KiB
PHP
75 lines
4.0 KiB
PHP
<div class="event index">
|
|
<h2>Automation</h2>
|
|
<p>Automation functionality is designed to automatically generate signatures for intrusion detection systems. To enable signature generation for a given attribute, Signature field of this attribute must be set to Yes.
|
|
Note that not all attribute types are applicable for signature generation, currently we only support NIDS signature generation for IP, domains, host names, user agents etc., and hash list generation for MD5/SHA1 values of file artifacts. Support for more attribute types is planned.
|
|
To to make this functionality available for automated tools an authentication key is used. This makes it easier for your tools to access the data without further form-based-authentiation.<br/>
|
|
<strong>Make sure you keep that key secret as it gives access to the entire database !</strong></p>
|
|
<p>Your current key is: <code><?php echo $me['authkey'];?></code>.
|
|
You can <?php echo $this->Html->link('reset', array('controller' => 'users', 'action' => 'resetauthkey', 'me'));?> this key.
|
|
</p>
|
|
|
|
<h3>XML Export</h3>
|
|
<p>An automatic export of all events and attributes <small>(except file attachments)</small> is available under a custom XML format.</p>
|
|
<p>You can configure your tools to automatically download the following file:</p>
|
|
<pre><?php echo Configure::read('CyDefSIG.baseurl');?>/events/xml/<?php echo $me['authkey']; ?></pre>
|
|
<p>If you only want to fetch a specific event append the eventid number:</p>
|
|
<pre><?php echo Configure::read('CyDefSIG.baseurl');?>/events/xml/<?php echo $me['authkey']; ?>/1</pre>
|
|
<p>Also check out the <?php echo $this->Html->link(__('User Guide', true), array('controller' => 'pages', 'action' => 'display', 'using_the_system', '#' => 'rest')); ?> to read about the REST API.</p>
|
|
<p></p>
|
|
|
|
<h3>NIDS signatures export</h3>
|
|
<p>Automatic export of all network related attributes is available under the Snort rule format. Only <em>published</em> events and attributes marked as <em>IDS Signature</em> are exported.</p>
|
|
<p>You can configure your tools to automatically download the following file:</p>
|
|
<pre><?php echo Configure::read('CyDefSIG.baseurl');?>/events/nids/<?php echo $me['authkey']; ?></pre>
|
|
<p></p>
|
|
<p>Administration is able to maintain a whitelist containing host, domain name and IP numbers to exclude from the NIDS export.</p>
|
|
|
|
<h3>Hash datatabse export</h3>
|
|
<p>Automatic export of MD5/SHA1 checksums contained in file-related attributes. This list can be used to feed forensic software when searching for susipicious files. Only <em>published</em> events and attributes marked as <em>IDS Signature</em> are exported.</p>
|
|
<p>You can configure your tools to automatically download the following files:</p>
|
|
<h4>md5</h4>
|
|
<pre><?php echo Configure::read('CyDefSIG.baseurl');?>/events/hids/md5/<?php echo $me['authkey']; ?></pre>
|
|
<h4>sha1</h4>
|
|
<pre><?php echo Configure::read('CyDefSIG.baseurl');?>/events/hids/sha1/<?php echo $me['authkey']; ?></pre>
|
|
<p></p>
|
|
|
|
<h3>Text export</h3>
|
|
<p>An automatic export of all attributes of a specific type to a plain text file.</p>
|
|
<p>You can configure your tools to automatically download the following files:</p>
|
|
<pre>
|
|
<?php
|
|
foreach ($sigTypes as $sigType) {
|
|
echo Configure::read('CyDefSIG.baseurl').'/events/text/'.$me['authkey'].'/'.$sigType . "\n";
|
|
}
|
|
?>
|
|
</pre>
|
|
<p></p>
|
|
|
|
<h3>Saved search XML export</h3>
|
|
<p>We plan to make it possible to export data using searchpatterns.<br/>
|
|
This would enable you to export:</p>
|
|
<ul>
|
|
<li>only your own attributes</li>
|
|
<li>date ranges</li>
|
|
<li>only specific attribute types (domain)</li>
|
|
<li>...</li>
|
|
</ul>
|
|
|
|
</div>
|
|
<div class="actions">
|
|
<ul class="nav nav-list">
|
|
<li><a href="/events/index">List Events</a></li>
|
|
<?php if ($isAclAdd): ?>
|
|
<li><a href="/events/add">Add Event</a></li>
|
|
<?php endif; ?>
|
|
<li class="divider"></li>
|
|
<li><a href="/attributes/index">List Attributes</a></li>
|
|
<li><a href="/attributes/search">Search Attributes</a></li>
|
|
<li class="divider"></li>
|
|
<li><a href="/events/export">Export</a></li>
|
|
<?php if ($isAclAuth): ?>
|
|
<li class="active"><a href="/events/automation">Automation</a></li>
|
|
<?php endif;?>
|
|
</ul>
|
|
</div>
|