<commit_before># GitHub Active Directory Connector

GitHub Connector is a simple application for connecting GitHub.com organizations to
internal Active Directory accounts.  It grants access to new hires, removes access
from terminated employees, and enforces a set of GitHub membership rules.

[![Build Status](https://travis-ci.org/rapid7/github-connector.svg?branch=master)](https://travis-ci.org/rapid7/github-connector)

## Table of contents

- [Quick Start](#quick-start)
- [Installation](#installation)
- [Running](#running)
- [Configuration](#configuration)
- [Synchronization](#synchornization)
- [Rules](#rules)
- [Tests](#tests)
- [Contributing](#contributing)
- [Copyright and License](#license)

## Quick start

- Clone the repo: `git clone git://github.com/rapid7/github-connector.git`
- Run bundler: `bundle install`
- Copy `config/secrets.yml.example` to `config/secrets.yml`
- Copy `config/database.yml.example` to `config/database.yml` and update
- Create database: `rake db:create db:migrate`
- Start application: `foreman start`
- Navigate to [http://localhost:5000](http://localhost:5000)

## Installation

GitHub Connector is a Rails 4 application.  It runs on Ruby > 2.0.  All settings are stored in a PostgreSQL database.

1. Install Ruby 2.x.  We recommend [RVM](https://rvm.io/).
2. If using RVM, create a gemset: `rvm gemset create github-connector && rvm gemset use github-connector`.
3. Install required gem dependencies: `bundle install`<commit_msg>README improvements<commit_after># GitHub Active Directory Connector

[![Build Status](https://travis-ci.org/rapid7/github-connector.svg?branch=master)](https://travis-ci.org/rapid7/github-connector)

GitHub Connector is a simple application for connecting GitHub.com organizations to
internal Active Directory accounts.  It grants access to new hires, removes access
from terminated employees, and enforces a set of GitHub membership rules.

GitHub Connector is a simple application for managing [GitHub.com organizations](https://help.github.com/categories/organizations/) using your internal Active Directory server. The Connector, an app which runs internally, allows you to:

* Automatically remove terminated employees from GitHub organization
* Audit each GiHub account for compliance with policies such as:
    * Ensure that only corporate email addresses are used for [GitHub accounts](https://developer.github.com/v3/users/emails/)
    * Ensure that [two-factor authentication](https://help.github.com/articles/about-two-factor-authentication/) is enabled for each account
* Enable one-step GitHub organization invite & acceptance for approved employees

Future feature ideas:
* Use AD group membership to control GitHub Organization and [GitHub Team](https://help.github.com/articles/adding-or-inviting-members-to-a-team-in-an-organization/) membership assignment
* Detect [duplicate/weak SSH keys](https://factorable.net/index.html) across all accounts

## Table of contents

- [Quick Start](#quick-start)
- [Installation](#installation)
- [Running](#running)
- [Configuration](#configuration)
- [Synchronization](#synchornization)
- [Rules](#rules)
- [Tests](#tests)
- [Contributing](#contributing)
- [Copyright and License](#license)

## Quick start

- Clone the repo: `git clone git://github.com/rapid7/github-connector.git`
- Run bundler: `bundle install`
- Copy `config/secrets.yml.example` to `config/secrets.yml`
- Copy `config/database.yml.example` to `config/database.yml` and update
- Create database: `rake db:create db:migrate`
- Start application: `foreman start`
- Navigate to [http://localhost:5000](http://localhost:5000)

## Installation

GitHub Connector is a Rails 4 application.  It runs on Ruby > 2.0.  All settings are stored in a PostgreSQL database.

1. Install Ruby 2.x.  We recommend [RVM](https://rvm.io/).
2. If using RVM, create a gemset: `rvm gemset create github-connector && rvm gemset use github-connector`.
3. Install required gem dependencies: `bundle install`
{'fraction_non_alphanumeric': 0.11718946047678795, 'fraction_numerical': 0.009284818067754079, 'mean_word_length': 5.04855842185129, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 5, 'https://': 11, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6898046', 'n_tokens_mistral': 1201, 'n_tokens_neox': 1117, 'n_words': 375}