# Changelog

# v0.6.0

# New

  • authenticate: support backend refresh @desimone [GH-438]
  • cache: add cache service @desimone [GH-457]

# Changed

  • authorize: consolidate gRPC packages @desimone [GH-443]
  • config: added yaml tags to all options struct fields @travisgroth [GH-394],[gh-397]
  • config: improved config validation for shared_secret @travisgroth [GH-427]
  • config: Remove CookieRefresh [GH-428] @u5surf [GH-436]
  • config: validate that shared_key does not contain whitespace @travisgroth [GH-427]
  • httputil : wrap handlers for additional context @desimone [GH-413]

# Fixed

  • proxy: fix unauthorized redirect loop for forward auth @desimone [GH-448]
  • proxy: fixed regression preventing policy reload GH-396

# Documentation

  • add cookie settings @danderson [GH-429]
  • fix typo in forward auth nginx example @travisgroth [GH-445]
  • improved sentence flow and other stuff @Rio [GH-422]
  • rename fwdauth to be forwardauth @desimone [GH-447]

# Dependency

  • chore(deps): update golang.org/x/crypto commit hash to 61a8779 @renovate [GH-452]
  • chore(deps): update golang.org/x/crypto commit hash to 530e935 @renovate [GH-458]
  • chore(deps): update golang.org/x/crypto commit hash to 53104e6 @renovate [GH-431]
  • chore(deps): update golang.org/x/crypto commit hash to e9b2fee @renovate [GH-414]
  • chore(deps): update golang.org/x/oauth2 commit hash to 858c2ad @renovate [GH-415]
  • chore(deps): update golang.org/x/oauth2 commit hash to bf48bf1 @renovate [GH-453]
  • chore(deps): update module google.golang.org/grpc to v1.26.0 @renovate [GH-433]
  • chore(deps): update module google/go-cmp to v0.4.0 @renovate [GH-454]
  • chore(deps): update module spf13/viper to v1.6.1 @renovate [GH-423]
  • chore(deps): update module spf13/viper to v1.6.2 @renovate [GH-459]
  • chore(deps): update module square/go-jose to v2.4.1 @renovate [GH-435]

# v0.5.0

# New

  • Session state is now route-scoped. Each managed route uses a transparent, signed JSON Web Token (JWT) to assert identity.
  • Managed routes no longer need to be under the same subdomain! Access can be delegated to any route, on any domain.
  • Programmatic access now also uses JWT tokens. Access tokens are now generated via a standard oauth2 token flow, and credentials can be refreshed for as long as is permitted by the underlying identity provider.
  • User dashboard now pulls in additional user context fields (where supported) like the profile picture, first and last name, and so on.

# Security

  • Some identity providers (Okta, Onelogin, and Azure) previously used mutable signifiers to set and assert group membership. Group membership for all providers now use globally unique and immutable identifiers when available.

# Changed

  • Azure AD identity provider now uses globally unique and immutable ID for group membership.
  • Okta no longer uses tokens to retrieve group membership. Group membership is now fetched using Okta's HTTP API. Group membership is now determined by the globally unique and immutable ID field.
  • Okta now requires an additional set of credentials to be used to query for group membership set as a service account.
  • URLs are no longer validated to be on the same domain-tree as the authenticate service. Managed routes can live on any domain.
  • OneLogin no longer uses tokens to retrieve group membership. Group membership is now fetched using OneLogin's HTTP API. Group membership is now determined by the globally unique and immutable ID field.

# Removed

  • Force refresh has been removed from the dashboard.
  • Previous programmatic authentication endpoints (/api/v1/token) has been removed and is no longer supported.

# Fixed

  • Fixed an issue where cookie sessions would not clear on error.GH-376

# v0.4.2

# Security

  • Fixes vulnerabilities fixed in 1.13.2 including CVE-2019-17596.

# v0.4.1

# Fixed

  • Fixed an issue where requests handled by forward-auth would not be redirected back to the underlying route after successful authentication and authorization. GH-363
  • Fixed an issue where requests handled by forward-auth would add an extraneous query-param following sign-in causing issues in some configurations. [GH-366]

# v0.4.0

# New

  • Allow setting request headers on a per route basis in policy. GH-308
  • Support "forward-auth" integration with third-party ingresses and proxies. nginx, nginx-ingress, and Traefik are currently supported. [GH-324]
  • Add insecure transport / TLS termination support. GH-328
  • Add setting to override a route's TLS Server Name. GH-297
  • Pomerium's session can now be passed as a bearer-auth header or query string in addition to as a session cookie.
  • Add host to the main request logger middleware. GH-308
  • Add AWS cognito identity provider settings. GH-314

# Security

  • The user's original intended location before completing the authentication process is now encrypted and kept confidential from the identity provider. GH-316
  • Under certain circumstances, where debug logging was enabled, pomerium's shared secret could be leaked to http access logs as a query param. GH-338

# Fixed

  • Fixed an issue where CSRF would fail if multiple tabs were open. GH-306
  • Fixed an issue where pomerium would clean double slashes from paths. GH-262
  • Fixed a bug where the impersonate form would persist an empty string for groups value if none set. GH-303
  • Fixed HTTP redirect server which was not redirecting the correct hostname.

# Changed

  • The healthcheck endpoints (/ping) now returns the http status 405 StatusMethodNotAllowed for non-GET requests.
  • Authenticate service no longer uses gRPC.
  • The global request logger now captures the full array of proxies from X-Forwarded-For, in addition to just the client IP.
  • Options code refactored to eliminate global Viper state. GH-332
  • Pomerium will no longer default to looking for certificates in the root directory. GH-328
  • Pomerium will validate that either insecure_server, or a valid certificate bundle is set. GH-328

# Removed

  • Removed AUTHENTICATE_INTERNAL_URL/authenticate_internal_url which is no longer used.

# v0.3.1

# Security

  • Fixes vulnerabilities fixed in Go 1.13.1 including CVE-2019-16276.

# v0.3.0

# New

  • GRPC Improvements. GH-261 / GH-69

    • Enable WaitForReady to allow background retries through transient failures
    • Expose a configurable timeout for backend requests to Authorize and Authenticate
    • Enable DNS round_robin load balancing to Authorize and Authenticate services by default

  • Add ability to set client certificates for downstream connections. GH-259

# Fixed

  • Fixed non-amd64 based docker images.GH-284
  • Fixed an issue where stripped cookie headers would result in a cookie full of semi-colons (Cookie: ;;;). GH-285
  • HTTP status codes now better adhere to RFC7235. In particular, authentication failures reply with 401 Unauthorized while authorization failures reply with 403 Forbidden. GH-272

# Changed

  • Pomerium will now strip _csrf cookies in addition to session cookies. GH-285

  • Disabled gRPC service config. GH-280

  • A policy's custom certificate authority can set as a file or a base64 encoded blob(tls_custom_ca/tls_custom_ca_file). GH-259

  • Remove references to service named ports and instead use their numeric equivalent. GH-266

# v0.2.1

# Security

  • Fixes vulnerabilities fixed in Go 1.12.8 including CVE-2019-9512, CVE-2019-9514 and CVE-2019-14809.

# v0.2.0

# New

# Telemetry GH-35

  • Tracing GH-230 aka distributed tracing, provides insight into the full lifecycles, aka traces, of requests to the system, allowing you to pinpoint failures and performance issues.

  • Metrics provide quantitative information about processes running inside the system, including counters, gauges, and histograms.

    • Add informational metrics. GH-227

    • GRPC Metrics Implementation. GH-218

      • Additional GRPC server metrics and request sizes
      • Improved GRPC metrics implementation internals
      • The GRPC method label is now 'grpc_method' and GRPC status is now grpc_client_status and grpc_server_status

    • HTTP Metrics Implementation. GH-220

      • Support HTTP request sizes on client and server side of proxy
      • Improved HTTP metrics implementation internals
      • The HTTP method label is now http_method, and HTTP status label is now http_status

# Changed

  • GRPC version upgraded to v1.22 GH-219
  • Add support for large cookie sessions by chunking. GH-211
  • Prefer curve X25519 to P256 for TLS connections. GH-233
  • Pomerium and its services will gracefully shutdown on interrupt signal. GH-230
  • Google now prompts the user to select a user account (by adding select_account to the sign in url). This allows a user who has multiple accounts at the authorization server to select amongst the multiple accounts that they may have current sessions for.

# FIXED

  • Fixed potential race condition when signing requests. GH-240
  • Fixed panic when reloading configuration in single service mode [GH-247]

# v0.1.0

# NEW

  • Add programmatic authentication support. GH-177
  • Add Prometheus format metrics endpoint. GH-35
  • Add policy setting to enable self-signed certificate support. GH-179
  • Add policy setting to skip tls certificate verification. GH-179

# CHANGED

  • Policy to and from settings must be set to valid HTTP URLs including schemes and hostnames (e.g. http.corp.domain.example should now be https://http.corp.domain.example).
  • Proxy's sign out handler {}/.pomerium/sign_out now accepts an optional redirect_uri parameter which can be used to specify a custom redirect page, so long as it is under the same top-level domain. GH-183
  • Policy configuration can now be empty at startup. GH-190
  • Websocket support is now set per-route instead of globally. GH-204
  • Golint removed from amd64 container. [GH-215]
  • Pomerium will error if a session cookie is over 4096 bytes, instead of failing silently. GH-212

# FIXED

  • Fixed HEADERS environment variable parsing. [GH-188]
  • Fixed Azure group lookups. GH-190
  • If a session is too large (over 4096 bytes) Pomerium will no longer fail silently. GH-211
  • Internal URLs like dashboard now start auth process to login a user if no session is found. GH-205.
  • When set,CookieDomain lets a user set the scope of the user session. CSRF cookies will still always be scoped at the individual route level. GH-181

# v0.0.5

# NEW

  • Add ability to detect changes and reload policy configuration files. GH-150
  • Add user dashboard containing information about the current user's session. GH-123
  • Add functionality allowing users to initiate manual refresh of their session. This is helpful when a user's access control details are updated but their session hasn't updated yet. To prevent abuse, manual refresh is gated by a cooldown (REFRESH_COOLDOWN) which defaults to five minutes. GH-73
  • Add Administrator (super user) account support (ADMINISTRATORS). GH-110
  • Add feature that allows Administrators to impersonate / sign-in as another user from the user dashboard. GH-110
  • Add docker images and builds for ARM. GH-95
  • Add support for public, unauthenticated routes. GH-129

# CHANGED

  • Add Request ID to error pages. GH-144
  • Refactor configuration handling to use spf13/viper bringing a variety of additional supported storage formats.GH-115
  • Changed config AUTHENTICATE_INTERNAL_URL to be a URL containing both a valid hostname and schema. GH-153
  • User state is now maintained and scoped at the domain level vs at the route level. GH-128
  • Error pages contain a link to sign out from the current user session. GH-100
  • Removed LifetimeDeadline from sessions.SessionState.
  • Removed favicon specific request handling. GH-131
  • Headers are now configurable via the HEADERS configuration variable. GH-108
  • Refactored proxy and authenticate services to share the same session state cookie. GH-131
  • Removed instances of extraneous session state saves. GH-131
  • Changed default behavior when no session is found. Users are now redirected to login instead of being shown an error page.GH-131
  • Updated routes such that all http handlers are now wrapped with a standard set of middleware. Headers, request id, loggers, and health checks middleware are now applied to all routes including 4xx and 5xx responses. GH-116
  • Changed docker images to be built from distroless. This fixed an issue with nsswitch GH-97, includes ca-certificates and limits the attack surface area of our images. GH-101
  • Changed HTTP to HTTPS redirect server to be user configurable via HTTP_REDIRECT_ADDR. GH-103
  • Content-Security-Policy hash updated to match new UI assets.

# FIXED

  • Fixed websocket support. GH-151
  • Fixed an issue where policy and routes were being pre-processed incorrectly. GH-132
  • Fixed an issue where golint was not being found in our docker image. GH-121

# v0.0.4

# CHANGED

  • HTTP Strict Transport Security is included by default and set to one year. GH-92
  • HTTP now redirects to HTTPS. GH-92
  • Removed extraneous AUTHORIZE_INTERNAL_URL config option since authorization has no public http handlers, only a gRPC service endpoint. GH-93
  • Removed PROXY_ROOT_DOMAIN config option which is now inferred from AUTHENTICATE_SERVICE_URL. Only callback requests originating from a URL on the same sub-domain are permitted. GH-83
  • Removed REDIRECT_URL config option which is now inferred from AUTHENTICATE_SERVICE_URL (e.g. https://$AUTHENTICATE_SERVICE_URL/oauth2/callback). GH-83

# FIXED

  • Fixed a bug in the Google provider implementation where the refresh_token. Updated the google implementation to use the new prompt=consent oauth2 parameters. Reported and fixed by @chemhack GH-81

# DOCUMENTATION

# v0.0.3

# FEATURES

  • Authorization : The authorization module adds support for per-route access policy. In this release we support the most common forms of identity based access policy: allowed_users, allowed_groups, and allowed_domains. In future versions, the authorization module will also support context and device based authorization policy and decisions. See website documentation for more details.

  • Group Support : The authenticate service now retrieves a user's group membership information during authentication and refresh. This change may require additional identity provider configuration; all of which are described in the updated docs. A brief summary of the requirements for each IdP are as follows:

    • Google requires the Admin SDK to enabled, a service account with properly delegated access, and IDP_SERVICE_ACCOUNT to be set to the base64 encoded value of the service account's key file.
    • Okta requires a groups claim to be added to both the id_token and access_token. No additional API calls are made.
    • Microsoft Azure Active Directory requires the application be given an additional API permission, Directory.Read.All.
    • Onelogin requires the groups was supplied during authentication and that groups parameter has been mapped. Group membership is validated on refresh with the user-info api endpoint.

  • WebSocket Support : With Go 1.12 pomerium automatically proxies WebSocket requests.

# CHANGED

  • Added LOG_LEVEL config setting that allows for setting the desired minimum log level for an event to be logged. GH-74
  • Changed POMERIUM_DEBUG config setting to just do console-pretty printing. No longer sets log level. GH-74
  • Updated generate_wildcard_cert.sh to generate a elliptic curve 256 cert by default.
  • Updated env.example to include a POLICY setting example.
  • Added IDP_SERVICE_ACCOUNT to env.example .
  • Removed ALLOWED_DOMAINS settings which has been replaced by POLICY. Authorization is now handled by the authorization service and is defined in the policy configuration files.
  • Removed ROUTES settings which has been replaced by POLICY.
  • Add refresh endpoint ${url}/.pomerium/refresh which forces a token refresh and responds with the json result.
  • Group membership added to proxy headers (x-pomerium-authenticated-user-groups) and (x-pomerium-jwt-assertion).
  • Default Cookie lifetime (COOKIE_EXPIRE) changed from 7 days to 14 hours ~ roughly one business day.
  • Moved identity (authenticate/providers) into its own internal identity package as third party identity providers are going to authorization details (group membership, user role, etc) in addition to just authentication attributes.
  • Removed circuit breaker package. Calls that were previously wrapped with a circuit breaker fall under gRPC timeouts; which are gated by relatively short timeouts.
  • Session expiration times are truncated at the second.
  • Removed gitlab provider. We can't support groups until this gitlab bug is fixed.
  • Request context is now maintained throughout request-flow via the context package enabling timeouts, request tracing, and cancellation.

# FIXED

  • http.Server and httputil.NewSingleHostReverseProxy now uses pomerium's logging package instead of the standard library's built in one. GH-58

← Troubleshooting→