Docs

Your own Slack app

By default, the cards for access requests come from the Alien app. A Slack app of your own white-labels them with your name and logo.

Either app approves. A click in your app decides a request the same as a click in the Alien app, on a Team card from a verified member of your Alien workspace and on a Customer card from the customer.

Your app for customer approvals

1  Brand            Acme Approvals · Access approvals from Acme
2  Create in Slack  Create it in Acme
3  Connect          Paste two values from Slack
4  Logo             Upload it in Slack, or skip
5  Try it           Send a test card to a channel

The app lives in your own Slack workspace, the one where you connected Alien. It's an internal app, so it needs no Slack Marketplace listing or review. Your customer installs nothing: they reach it through the Slack Connect channel you share with them.

Only workspace admins set it up. Other members see which app customers see.

Set up

Open Settings → Integrations → Slack, and find Your app for customer approvals. Connect Slack first. The app must live in the same Slack workspace.

Brand. Set the App name (up to 35 characters), a Short description (up to 140), and a Color as #RRGGBB. The preview shows what customers see in Slack. Select Save and continue.

Create in Slack. Select Create the app in Slack. Slack opens with the app filled in. Pick your Slack workspace, select Next, then Create and Install, then Allow. Back in Alien, select I've installed it.

If no install window appears, open the app in Slack's app settings and select Install App.

Connect. Paste the Bot User OAuth Token from OAuth & Permissions, and the Signing Secret from Basic Information → App Credentials (select Show). Select Connect.

Logo. Slack doesn't take the logo from the link. Select Download logo, then upload it as the App icon under Basic Information → Display Information. You can skip this step.

Try it. In Slack, run /invite @Acme Approvals in the channel you will test in. Back in Alien, pick the channel and select Send test card. Click a button on the card.

The reply to a button click reads This is a test card. Acme Approvals received your click, so approvals will work. Only you see it. Select Done to finish.

After you connect, the Approvals row on a deployment page adds Customers see Acme Approvals.

What Alien checks

When you select Connect, Alien checks that:

  • the token is a bot token that starts with xoxb- and Slack accepts it
  • the app is in the same Slack workspace as the Alien app
  • the token is not the Alien app's own
  • the app has the chat:write, users:read and users:read.email scopes
  • the signing secret is 32 hex characters

users:read.email lets Alien read the confirmed email of a person who clicks. On a Team card it matches them to a member of your Alien workspace. On a Customer card it refuses anyone whose email belongs to one. The link in step 2 also requests team:read.

Slack gives no way to check a signing secret on Connect. The test card does: its buttons answer only through your app's own interactivity URL, which verifies the secret. If a click gets no reply, replace the credentials.

ErrorFix
Create the app in Acme, the Slack workspace where Alien is installed.The token belongs to another Slack workspace. Create the app in the workspace named in the message.
Slack didn't accept this token (invalid_auth). Copy the Bot User OAuth Token, which starts with xoxb-, from OAuth & Permissions.The token is wrong or the app isn't installed. Install it, then copy the token again.
This is the Alien app's token. Paste the token of the app you created.Use the token of your own app.
The app is missing chat:write. Create it from the link above, or add the scopes in OAuth & Permissions and reinstall it.The message names every missing scope.
That isn't a signing secret. Copy the 32-character Signing Secret from Basic Information.Copy the secret, not the Client Secret or the token.
Connect Slack first. Your app lives in the same Slack workspace.Connect Slack under Integrations, then return.

Invite the app

Invite the app to every Slack Connect channel where cards go. The Alien app doesn't post in its place.

/invite @Acme Approvals

When the app isn't in the channel, the engineer who routes the card sees Invite @Acme Approvals to #acme-support, then try again. Nothing was sent. The test card gives the same hint.

Replace credentials

Select Replace credentials to paste a new token or signing secret for the same Slack app. Cards the app already posted keep working. An app created before users:read.email was required needs that scope: add it in OAuth & Permissions, reinstall the app, and replace the credentials with the new token.

To use a different Slack app, disconnect first. Alien refuses credentials from another app with These credentials belong to a different Slack app.

Disconnect

Select Disconnect and confirm. New cards go out from the Alien app again.

Cards your app already posted can no longer be updated when the request is decided or revoked. The app stays in your Slack until you delete it there.

Next

On this page