trustymail_reporter

KO | EN

gitlite — search

#javascript #ai #llm #golang #android #linux #docker #macos #nodejs #kubernetes #awesome-list #vue #pytorch #security

trustymail_reporter

(★ 13)

Generate Trustworthy Email reports based on scan data

trustymail_reporter 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Trustworthy Email Reporter #

[![GitHub Build Status](https://github.com/cisagov/trustymail_reporter/workflows/build/badge.svg)](https://github.com/cisagov/trustymail_reporter/actions/workflows/build.yml)
[![License](https://img.shields.io/github/license/cisagov/trustymail_reporter)](https://spdx.org/licenses/)
[![CodeQL](https://github.com/cisagov/trustymail_reporter/workflows/CodeQL/badge.svg)](https://github.com/cisagov/trustymail_reporter/actions/workflows/codeql-analysis.yml)

## Docker Image ##

[![Docker Pulls](https://img.shields.io/docker/pulls/cisagov/trustymail_reporter)](https://hub.docker.com/r/cisagov/trustymail_reporter)
[![Docker Image Size (latest by date)](https://img.shields.io/docker/image-size/cisagov/trustymail_reporter)](https://hub.docker.com/r/cisagov/trustymail_reporter)
[![Platforms](https://img.shields.io/badge/platforms-amd64%20%7C%20arm64-blue)](https://hub.docker.com/r/cisagov/trustymail_reporter/tags)

This is a Docker container that creates PDF reports for individual
second-level domains using data collected via
[trustymail](https://github.com/cisagov/trustymail) scans.

This Docker container is intended to be run via
[orchestrator](https://github.com/cisagov/orchestrator).

**N.B.:** The secrets in the `src/secrets` directory are only used
when testing via the `docker-compose.yml` composition.  Normally this
Docker container is run via the Docker composition in
[cisagov/orchestrator](https://github.com/cisagov/orchestrator), which
expects the secrets in a different location.

## Running ##

### Running with Docker ###

To run the `cisagov/trustymail_reporter` image via Docker:

```console
docker run cisagov/trustymail_reporter:1.7.5
```

### Running with Docker Compose ###

1. Create a `compose.yml` file similar to the one below to use [Docker Compose](https://docs.docker.com/compose/).

```yaml
    ---
    name: trustymail_reporter

services:
      trustymail_reporter:
        image: cisagov/trustymail_reporter:1.7.5
        volumes:
          - type: bind
            source: <your_log_dir>
            target: /home/cisa/shared
    ```

1. Start the container and detach:

```console
    docker compose up --detach
    ```

## Using secrets with your container ##

This container also supports passing sensitive values via [Docker
secrets](https://docs.docker.com/engine/swarm/secrets/).  Passing sensitive
values like your credentials can be more secure using secrets than using
environment variables.  See the
[secrets](#secrets) section below for a table of all supported secret files.

1. To use secrets, create a `database_creds.yml` file in [this
   format](https://github.com/cisagov/mongo-db-from-config#usage):

```yaml
    ---
    version: '1'

database:
      name: cyhy
      uri: mongodb://readonly:the_password@cyhy.example.com:27017/cyhy

```

1. Next create an `aws_config` file in [this
   format](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html):

```ini
    [default]
    aws_access_key_id=AKIAIOSFODNN7EXAMPLE
    aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
    region=us-east-1
    output=json
    ```

1. Then add the secrets to your `docker-compose.yml` file:

```yaml
    ---
    name: trustymail_reporter

secrets:
      aws_config:
        file: ./secrets/aws_config
      database_creds:
        file: database_creds.yml

services:
      trustymail_reporter:
        image: cisagov/trustymail_reporter:1.7.5
        volumes:
          - type: bind
            source: <your_log_dir>
            target: /home/cisa/shared
        secrets:
          - source: aws_config
            target: aws_config
          - source: database_creds
            target: database_creds.yml
    ```

## Updating your container ##

### Docker Compose ###

1. Pull the new image from Docker Hub:

```console
    docker compose pull
    ```

1. Recreate the running container by following the [previous instructions](#running-with-docker-compose):

```console
    docker compose up --detach
    ```

### Docker ###

1. Stop the running container:

```console
    docker stop <container_id>
    ```

1. Pull the new image:

```console
    docker pull cisagov/trustymail_reporter:1.7.5
    ```

1. Recreate and run the container by following the [previous instructions](#running-with-docker).

## Updating Python dependencies ##

This image uses [Pipenv] to manage Python dependencies using a [Pipfile](https://github.com/pypa/pipfile).
Both updating dependencies and changing the [Pipenv] configuration in `src/Pipfile`
will result in a modified `src/Pipfile.lock` file that should be committed to the
repository.

### Updating dependencies ###

If you want to update existing dependencies you would run the following command
in the `src/` subdirectory:

```console
pipenv lock
```

### Modifying dependencies ###

If you want to add or remove dependencies you would update the `src/Pipfile` file
and then update dependencies as you would above.

> [!NOTE]
> You should only specify packages that are direct requirements of
> your Docker configuration. Allow [Pipenv] to manage the dependencies
> of the specified packages.

## Image tags ##

The images of this container are tagged with [semantic
versions](https://semver.org) of the underlying example project that they
containerize.  It is recommended that most users use a version tag (e.g.
`:1.7.5`).

| Image:tag | Description |
| --------- | ----------- |
| `cisagov/trustymail_reporter:1.7.5` | An exact release version. |
| `cisagov/trustymail_reporter:1.7` | The most recent release matching the major and minor version numbers. |
| `cisagov/trustymail_reporter:1` | The most recent release matching the major version number. |
| `cisagov/trustymail_reporter:edge` | The most recent image built from a merge into the `develop` branch of this repository. |
| `cisagov/trustymail_reporter:nightly` | A nightly build of the `develop` branch of this repository. |
| `cisagov/trustymail_reporter:latest` | The most recent release image pushed to a container registry.  Pulling an image using the `:latest` tag [should be avoided.](https://vsupalov.com/docker-latest-tag/) |

See the [tags
tab](https://hub.docker.com/r/cisagov/trustymail_reporter/tags) on
Docker Hub for a list of all the supported tags.

## Volumes ##

| Mount point | Purpose |
| ----------- | ------- |
| /home/cisa/shared | Output |

## Ports ##

There are no ports exposed by this container.

## Environment variables ##

### Required ###

There are no required environment variables.

### Optional ###

There are no optional environment variables.

## Secrets ##

| Filename | Purpose |
| -------- | ------- |
| database_creds.yml | Cyber Hygiene read-only database credentials in [this format](https://github.com/cisagov/mongo-db-from-config#usage) |
| aws_config | AWS credentials allowing read-only access to the Elasticsearch DMARC database in [this format](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) |

## Building from source ##

Build the image locally using this git repository as the [build context](https://docs.docker.com/engine/reference/commandline/build/#git-repositories):

```console
docker build \
  --tag cisagov/trustymail_reporter:1.7.5 \
  https://github.com/cisagov/trustymail_reporter.git#develop
```

## Cross-platform builds ##

To create images that are compatible with other platforms, you can use the
[`buildx`](https://docs.docker.com/buildx/working-with-buildx/) feature of
Docker:

1. Copy the project to your machine using the `Code` button above
   or the command line:

```console
    git clone https://github.com/cisagov/trustymail_reporter.git
    cd trustymail_reporter
    ```

1. Create the `Dockerfile-x` file with `buildx` platform support:

```console
    ./buildx-dockerfile.sh
    ```

1. Build the image using `buildx`:

```console
    docker buildx build \
      --file Dockerfile-x \
      --platform linux/amd64 \
      --output type=docker \
      --tag cisagov/trustymail_reporter:1.7.5 .
    ```

## Contributing ##

We welcome contributions!  Please see [`CONTRIBUTING.md`](CONTRIBUTING.md) for
details.

## License ##

This project is in the worldwide [public domain](LICENSE).

This project is in the public domain within the United States, and
copyright and related rights in the work worldwide are waived through
the [CC0 1.0 Universal public domain
dedication](https://creativecommons.org/publicdomain/zero/1.0/).

All contributions to this project will be released under the CC0
dedication. By submitting a pull request, you are agreeing to comply
with this waiver of copyright interest.

[Pipenv]: https://pypi.org/project/pipenv/

trustymail_reporter

trustymail_reporter 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

trustymail_reporter

trustymail_reporter 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README