
# Timestamping Enricher
```{admonition} Module type

<span style='color: #0000FF'>[enricher](/core_modules.md#enricher-modules)</a></span>
```

Generates RFC3161-compliant timestamp tokens using Time Stamp Authorities (TSA) for archived files.

### Features
- Creates timestamp tokens to prove the existence of files at a specific time, useful for legal and authenticity purposes.
- Aggregates file hashes into a text file and timestamps the concatenated data.
- Uses multiple Time Stamp Authorities (TSAs) to ensure reliability and redundancy.
- Validates timestamping certificates against trusted Certificate Authorities (CAs) using the `certifi` trust store.

### Notes
- Should be run after the `hash_enricher` to ensure file hashes are available.
- Requires internet access to interact with the configured TSAs.


## Configuration Options

### YAML
```{code} yaml

# steps configuration
steps:
...
  enrichers:
  - timestamping_enricher
...

# module configuration
...

timestamping_enricher:
  tsa_urls:
  - http://timestamp.digicert.com
  - http://timestamp.identrust.com
  - http://timestamp.globalsign.com/tsa/r6advanced1
  - http://tss.accv.es:8318/tsa



```

### Command Line:
| Option | Description | Default | Type|
| --- | --- | --- | --- |
| `timestamping_enricher.tsa_urls` | Optional. List of RFC3161 Time Stamp Authorities to use, separate with commas if passed via the command line. | ['http://timestamp.digicert.com', 'http://timestamp.identrust.com', 'http://timestamp.globalsign.com/tsa/r6advanced1', 'http://tss.accv.es:8318/tsa'] | string |

[API Reference](../../../autoapi/timestamping_enricher/index)
