Public Slack organizations made easy
JavaScript Shell CSS
Latest commit f3e3b3d Aug 2, 2017 @davidalves1 davidalves1 committed with leo Change the Node default version to resolve the DoS problem on Heroku (#…
…327)

* Update splash.js

* Change the Node version to resolve the DoS problem on Heroku

* Undo translations to pt-BR
Permalink
Failed to load latest commit information.
bin Implement reCAPTCHA for abuse prevention (#311) Jun 1, 2017
lib
scripts Deploy to Azure Button Jan 6, 2016
test Supports letsencrypt challenges (#239) Sep 26, 2016
.gitignore Include dist in deploy. Fix #221. (#223) Feb 9, 2017
.travis.yml Add .travis.yml Feb 24, 2016
Dockerfile
HISTORY.md Release 0.13.0 Jul 20, 2016
Procfile Implement reCAPTCHA for abuse prevention (#311) Jun 1, 2017
app.json Implement reCAPTCHA for abuse prevention (#311) Jun 1, 2017
azuredeploy.json Deploy to Azure Button Jan 6, 2016
gulpfile.babel.js Switch to args, lint code and clean up (#200) Jun 17, 2016
license.md Lowercased text files Jun 7, 2017
package.json Change the Node default version to resolve the DoS problem on Heroku (#… Aug 2, 2017
readme.md
web.config Deploy to Azure Button Jan 6, 2016

readme.md

Features

  • A landing page you can point users to fill in their emails and receive an invite (https://slack.yourdomain.com)
  • An <iframe> badge to embed on any website that shows connected users in realtime with socket.io.
  • A SVG badge that works well from static mediums (like GitHub README pages)
  • Abuse prevention via Google reCAPTCHA

Check out the Demo or read more about the motivations and history behind Slackin.

Usage

Set up Now on your device and run this command. Now will automatically ask you for the required information and then spin up a deployment instantly. That easy!

now rauchg/slackin

Other platforms:

Tips

Your team id is what you use to access your login page on Slack (eg: https://{this}.slack.com).

You can find or generate your API test token at api.slack.com/web – note that the user you use to generate the token must be an admin. You need to create a dedicated @slackin-inviter user (or similar), mark that user an admin, and use a test token from that dedicated admin user. Note that test tokens have actual permissions so you do not need to create an OAuth 2 app. Also check out the Slack docs on generating a test token.

Important: If you use Slackin in single-channel mode, you'll only be able to invite as many external accounts as paying members you have times 5. If you are not getting invite emails, this might be the reason. Workaround: sign up for a free org, and set up Slackin to point to it (all channels will be visible).

Here is where to generate a secret and sitekey for Google reCAPTCHA.

Badges

Realtime (demo)

<script async defer src="https://slack.yourdomain.com/slackin.js"></script>
<!-- append "?" to the URL for the large version -->

SVG (demo)

<img src="https://slack.yourdomain.com/badge.svg">

API

Loading slackin will return a Function that creates a HTTP.Server instance:

const slackin = require('slackin')

slackin.default({
  token: 'yourtoken',                             // required
  interval: 1000,
  org: 'your-slack-subdomain',                    // required
  path: '/some/path/you/host/slackin/under/',     // defaults to '/'
  channels: 'channel,channel,...',                // for single channel mode
  silent: false                                   // suppresses warnings
}).listen(3000)

This will show response times from Slack and how many online users you have on the console. The returned http.Server has an app property that is the express application that you can define or override routes on.

All the metadata for your organization can be fetched via a JSON HTTP request to /data.

Caught a Bug?

  1. Fork this repository to your own GitHub account and then clone it to your local device
  2. Uninstall slackin if it's already installed: npm uninstall -g slack
  3. Link it to the global module directory: npm link
  4. Transpile the source code and watch for changes: npm start

Yey! Now can use the slack command everywhere.