GitHub

Repositories

View a list of all repositories tagged for Login.gov

Applications

• 18f/identity-idp
  secure.login.gov
  IDP (main application)

• 18f/identity-pki PIV/CAC application

• 18f/identity-idp-config Service Provider (service_providers.yml) and Agency (agencies.yml) configuration repo that can be updated and deployed independently of the IDP.

• 18f/identity-dashboard Partner Dashboard for viewing and editing service provider configurations (only in the INT environment).

• 18f/identity-charts (Archived)
  login-charts-server.app.cloud.gov
  Metrics dashboard for Login.gov

Libraries

• 18f/identity-hostdata Gem that provides functionality for our Ruby applications on our EC2 infrastructure to download secrets and read configs.

• 18F/omniauth_login_dot_gov Provides an Omniauth strategy for Login.gov that helps other projects integrate with Login.gov more easily. Some use cases include the identity-dashboard as well as Touchpoints, USMC and search.gov

• 18f/identity-validations Gem that provides shared validations for the ServiceProvider model across the IDP and dashboard

• 18f/identity-telephony (Archived) Gem that provides a common interface for voice and SMS features across multiple vendor backends. This code has been moved into the IDP codebase.

• 18f/identity-doc-auth (Archived) Provides a library for performing document authentication. This code has been moved into the IDP codebase.

• 18f/identity-proofer-gem (Archived) Provides a generic interface around identity proofing (IDV, identity verification) that is implemented by other proofers. This code has been moved into the IDP codebase.

• 18f/identity-lexisnexis-api-client-gem (Archived) Implementation of the identity-proofer interface for LexisNexis. This code has been moved into the IDP codebase.

• 18f/identity-aamva-api-client-gem (Archived) Implementation of the identity-proofer interface for AAMVA for drivers licenses. This code has been moved into the IDP codebase.

Example Applications

• 18f/identity-oidc-sinatra Example service provider that uses OpenID connect and Sinatra.

• 18f/identity-saml-rails Example service provider that uses SAML and Rails.

Platform and Infrastructure

• 18f/identity-devops Platform CLI tools, Terraform for infrastructure as code (IaC), Chef for instance (server) provisioning, and so much more! (Too much more?)

• 18f/identity-devops-private Per-application environment additional Terraform and Chef configurations

• 18f/identity-terraform Publicly shared Terraform modules

• 18f/identity-cookbooks Publicly shared Chef cookbooks

• 18f/identity-base-image AWS EC2 Image (AMI) definitions and build pipelines to match

• 18f/identity-monitor Smoke tests and NewRelic scripts that test the site

• 18f/identity-lambda-functions AWS Lambda functions and the code to deploy them - Only used for KMS matching code at this time

Design

• 18f/identity-design-assets A place for the Login.gov design team to version and store design assets (illustrations, sketch files, etc.)

Static Sites

• 18f/identity-site
  login.gov
  Hosted on: Federalist
  Public marketing page.

• 18f/identity-style-guide
  design.login.gov
  Hosted on: Federalist
  Walkthrough of Login.gov common styles. The respository also hosts the identity-style-guide npm package that contains the actual styles.

• 18f/identity-dev-docs
  developers.login.gov
  Hosted on: Federalist
  Developer documentation and integration guides for OpenID Connect and SAML.

• 18f/connect.gov
  connect.gov
  Hosted on: Federalist
  A site to disambiguate the Login.gov’s predecessor connect.gov from Connecticut’s ConnectCT connect.ct.gov

• 18f/identity-partners-site
  partners.login.gov
  Hosted on: Federalist
  A site to present information for partners

• 18f/identity-reporting
  data.login.gov
  Hosted on: Federalist
  Public reporting dashboard.

• 18f/identity-handbook
  handbook.login.gov
  Hosted on: Federalist
  This handbook!

• 18f/identity-handbook-private
  login-handbook.app.cloud.gov
  Hosted on: Cloud.gov
  Old, private version of this handbook! (Private to Login.gov team only)

Permissions

All Login.gov repos should have the following permissions. They can be changed by a current admin under “Settings” > “Manage Access” in Github.

Group Name	Role
identity-admins	Admin
identity-core	Write
identity-partners	Read
identity-ro	Read

We should not have any individual access, only team access.

Email Notifications and Filters

Default settings for GitHub can generate a lot of email that can be tough to sift through. Here are some strategies for helping manage these notifications:

1. Create Gmail filters to help highlight mentions:

   • A filter to get emails out of the Inbox

     list:18F.github.com
     Skip Inbox, Apply label: github

   • A mentions/me filter to highlight Pull Requests you’re participating in (such as being tagged as a reviewer)

     from:notifications@github.com to:me
     Apply label: github-me

   Example:

   

2. In GitHub, only have notifications on for repositories you care about (unwatch all others). The 18F org has many repos that do not affect Login.gov. For example, set up “All Activity” for identity- repos, and “Participating” for all others.

   Key Repositories	Other Repositories