https://github.com/nodecraft/2fa-2-slack

Micro-app to send SMS 2FA codes to a slack Channel. Ideal for teams that want a secure login, without the headaches of a single 2FA gatekeeper.
https://github.com/nodecraft/2fa-2-slack

2fa slack sms twilio twilio-api twilio-sms-api

Last synced: 2 months ago
JSON representation

Micro-app to send SMS 2FA codes to a slack Channel. Ideal for teams that want a secure login, without the headaches of a single 2FA gatekeeper.

• Host: GitHub
• URL: https://github.com/nodecraft/2fa-2-slack
• Owner: nodecraft
• License: mit
• Created: 2017-09-12T17:00:03.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2024-05-06T09:38:43.000Z (8 months ago)
• Last Synced: 2024-08-01T02:34:33.898Z (5 months ago)
• Topics: 2fa, slack, sms, twilio, twilio-api, twilio-sms-api
• Language: JavaScript
• Size: 456 KB
• Stars: 14
• Watchers: 4
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 2fa-2-Slack

[![CircleCI](https://circleci.com/gh/nodecraft/2fa-2-slack.svg?style=svg)](https://circleci.com/gh/nodecraft/2fa-2-slack) [![Greenkeeper badge](https://badges.greenkeeper.io/nodecraft/2fa-2-slack.svg)](https://greenkeeper.io/)

Micro-app to send SMS 2FA codes to a slack Channel. Ideal for teams that want a secure login, without the headaches of a single 2FA gatekeeper.

### Requirements

 - Twilio Phone number that supports SMS messaging

 - Slack Webhook URL

 - Publicly accessible ip with port `8888`

### Setup & Configuration

 - *(recommended)* Add emotes from [Slackmojis](https://slackmojis.com/) for

   - `:twitter:`

   - `:google:`

   - `:paypal:`

   - `:authy:`

   - `:stripe:`

- `npm install` to install dependancies

- Set your Twilio Message Callback URL to `http://your-hostname:8888/sms`

- Set your Twilio Voice Callback URL to `http://your-hostname:8888/voice` *(optional)*

- Update `config/slack.json` to reflect your Slack Webhook URL

- Update `config/numbers.json` to reflect your desired redirect number for voice calls

- Update `config/numbers.json` to add any additional numbers or adjust emotes *(optional)*

- `npm start` to start the application.

### Known supported Apps

The following services and phones work with this system:

 - Twitch.tv

 - Google accounts

 - Paypal

 - Stripe

 - Dialpad

 - Mobile Phones

### Unsupported Apps

These apps detect the phone number type or have refused to send SMS messages to Twilio:

 - Twitter

 - Amazon

 - Instagram

#### Roadmap

 - [ ] Add support for TOTP via commands

 - [ ] Add more phone numbers & apps icons

 - [ ] Convert app to Oauth2 based Slack app to provide button UI for claiming 2fa code.