Git Product home page Git Product logo

twofactorauth's Introduction

TwoFactorAuth.org Build Status

A list of popular sites and whether or not they accept two factor auth.

The Goal

The goal is to have a website with a comprehensive list of sites that support two factor auth as well as the methods that they support it.

This is to aid when deciding on alternative services based on the security they offer for their customers.

This also is a way for consumers to see what sites still need to invest in further security practices and which ones already do.

Contributing

All the data is managed through a series of Yaml files so it may be useful to read up on the Yaml syntax.

To add a new site, go to the data files and get familiar with how it is setup. There is a section and coresponding file for each Category and they all follow this syntax:

Guidelines

  1. Don't break the build: We have a simple continuous integration system setup with Travis. If your pull request doesn't pass, it won't be merged.

    To manually test the build, just run the following:

    $ ruby verify.rb
  2. Use a Nice Icon: The icon must be 32x32 in dimension. Earlier we were using 16x16 but upgraded for various high density screens.

  3. Be Awesome: You need to be awesome. That is all.

New Sections

To add a new section, modify the sections value in main.yml and follow the template below:

sections:
  - id: category-id
    title: Category Name
    icon: icon-class

Then create a new file in the _data directory named the same as your section's id with the .yml extension.

New Sites

The values should be pretty straight forward for adding a new website. The websites array should already be defined, just add a new website to it like this example:

    websites:
        - name: Site
          url: https://site.com
          img: site.png
          twitter: twitter_handle   # To tweet at site, if tfa is No
          tfa: Yes
          goog: Yes
          authy: Yes
          verisign: Yes
          sms: Yes
          doc: <url to the documentation>
          custom:
              - icon: android
                url: <url to a custom Android client>
              - icon: apple
                url: <url to a custom iOS client>
              # Any other custom clients...

If a site does not have 2FA but there is documentation that they are adding it, then use

tfa: no
status: <url to documentation>

Note: A tip on getting icons, use Google's icon api. Just go to https://www.google.com/s2/favicons?domain=http://example.com and you will get sites the icon as png.

We are now looking for higher resolution images than offered by Google's favicon service.

Custom

The custom section is for an app or site that doesn't use SMS, Google Auth, or Authy. This app should have its own way of generating 2FA from within the app or a special 2FA service such as via email, yubikey, etc.

License

This code is distributed under the MIT license. For more info, read the LICENSE file distributed with the source code.

twofactorauth's People

Contributors

jdavis avatar computmaxer avatar zach-taylor avatar richjeanes avatar victorhaggqvist avatar robfreiburger avatar smarkwell avatar helwy avatar kevinbongart avatar terrance avatar mxxcon avatar coreymatyas avatar joehallissey avatar fallenpegasus avatar sudeepkodavati avatar alexiip avatar elektron9 avatar mmahadevan-okta avatar matthewgall avatar gildotdev avatar benjholla avatar cadadr avatar semencov avatar ryanwkeen avatar meatballs avatar noodlesnz avatar mkdynamic avatar ilyakatz avatar marenpeasley avatar stlcajun avatar

Watchers

James Cloos avatar David Lohle avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.