Contents

# Test plugin: `ports`

The `ports` test plugin checks that nodes' ports are setup correctly (opened or closed).
Useful to check for firewall deployments and general network/security settings.

## Config DSL extension

### `check_opened_ports`

Check that a given list of ports are opened.
Takes as parameter a list of (or single) port numbers.

Example:
```ruby
# Check that our web services are listing on https
for_nodes('/.*web.*/') do
  check_opened_ports 443
end
```

### `check_closed_ports`

Check that a given list of ports are closed.
Takes as parameter a list of (or single) port numbers.

Example:
```ruby
# Check that smtp and pop3 are closed on all nodes
check_closed_ports 25, 110
```

## Used credentials

| Credential | Usage
| --- | --- |

## Used Metadata

| Metadata | Type | Usage
| --- | --- | --- |
| `host_ip` | `String` | Host IP address to be tested for port listening |

## Used environment variables

| Variable | Usage
| --- | --- |

## External tools dependencies

None

Version data entries

13 entries across 13 versions & 1 rubygems

Version	Path
hybrid_platforms_conductor-32.17.0	docs/plugins/test/ports.md
hybrid_platforms_conductor-32.16.4	docs/plugins/test/ports.md
hybrid_platforms_conductor-32.16.3	docs/plugins/test/ports.md
hybrid_platforms_conductor-32.16.2	docs/plugins/test/ports.md
hybrid_platforms_conductor-32.16.1	docs/plugins/test/ports.md
hybrid_platforms_conductor-32.16.0	docs/plugins/test/ports.md
hybrid_platforms_conductor-32.15.0	docs/plugins/test/ports.md
hybrid_platforms_conductor-32.14.0	docs/plugins/test/ports.md
hybrid_platforms_conductor-32.13.4	docs/plugins/test/ports.md
hybrid_platforms_conductor-32.13.3	docs/plugins/test/ports.md
hybrid_platforms_conductor-32.13.2	docs/plugins/test/ports.md
hybrid_platforms_conductor-32.13.1	docs/plugins/test/ports.md
hybrid_platforms_conductor-32.13.0	docs/plugins/test/ports.md