mirror of
https://github.com/pomerium/pomerium.git
synced 2025-07-08 12:28:18 +02:00
53 lines
2.5 KiB
Markdown
53 lines
2.5 KiB
Markdown
<a href="https://pomerium.com" title="Pomerium is a zero trust, context and identity aware access proxy."><img src="https://www.pomerium.com/wp-content/uploads/2021/08/Pomerium-H-white-bg.png" height="70" alt="pomerium logo"></a>
|
|
|
|
[](https://goreportcard.com/report/github.com/pomerium/pomerium)
|
|
[][godocs]
|
|
[](https://github.com/pomerium/pomerium/blob/main/LICENSE)
|
|
|
|
|
|
Pomerium is an identity and context-aware reverse proxy that brokers secure access to apps and services at scale. Pomerium provides a standardized interface to add access control to applications regardless of whether the application itself has authorization or authentication baked-in.
|
|
|
|
Pomerium can be used in situations where you'd typically reach for a VPN, but, unlike a VPN, does not require a client and uses identity and context, not network locality to determine access.
|
|
|
|
Pomerium can be used to:
|
|
|
|
- provide a **single-sign-on gateway** to internal applications.
|
|
- enforce **dynamic access policy** based on **context**, **identity**, and **device identity**.
|
|
- aggregate access logs and telemetry data.
|
|
- a **VPN alternative**.
|
|
|
|
## Docs
|
|
|
|
For comprehensive docs, and tutorials see our [documentation].
|
|
|
|
[documentation]: https://pomerium.com/docs/
|
|
[go environment]: https://golang.org/doc/install
|
|
[godocs]: https://godoc.org/github.com/pomerium/pomerium
|
|
[quick start guide]: https://www.pomerium.com/docs/install/quickstart
|
|
|
|
## Integration Tests
|
|
|
|
To run the integration tests locally, first build a local development image:
|
|
|
|
```bash
|
|
./scripts/build-dev-docker.bash
|
|
```
|
|
|
|
Next go to the `integration/clusters` folder and pick a cluster, for example `google-single`, then use docker-compose to start the cluster. We use an environment variable to specify the `dev` docker image we built earlier:
|
|
|
|
```bash
|
|
cd integration/clusters/google-single
|
|
env POMERIUM_TAG=dev docker-compose up -V
|
|
```
|
|
|
|
Once that's up and running you can run the integration tests from another terminal:
|
|
|
|
```bash
|
|
go test -count=1 -v ./integration/...
|
|
```
|
|
|
|
If you need to make a change to the clusters themselves, there's a `tpl` folder that contains `jsonnet` files. Make a change and then rebuild the clusters by running:
|
|
|
|
```bash
|
|
go run ./integration/cmd/pomerium-integration-tests/ generate-configuration
|
|
```
|