Background:
Understanding the workflow of the website is helpful.


The auth-linking process will cycle you among three websites. The Main MNDS dashboard, the MNDS Auth Gizmo and the EVE SSO Login site.

The two MNDS sites look a bit alike but are unique, let's take a look.

Main Dashboard
There are a few things that identify this as the Dashboard.
  • The URL just says mindstar.technology
  • The menu in the upper left clearly says "Dashboard". So does the tab title.
  • The EVE SSO Login button reminds you to only login with your main character.

Auth Gizmo
There are a few things that identify this as the ESI Auth Gizmo.
  • The URL says auth.mindstar.technology
  • The menu in the upper left clearly says "Auth". So does the tab title.
  • In the top center of the page it says "ESI Auth Token Gizmo".
  • The EVE SSO Login button is not surrounded by the red reminder boxes.


Workflow:
Both the Dashboard and Auth sites are visited in a certain order.


The two sites yield different types of logins via the EVE SSO. The Dashboard just verifies who you are, but does not grant any permissions to poll your user data. The forum does this same type of SSO login. The Auth site is different. It's like the old sytle XML API keys. It grants a "full API Key" on the character you used to login. We then need to link all of these Auth Tokens to your main character.

NOTE:
CCP Changed the ways things are done when they created the new ESI API. In the past, when you created an XML API key, you had to make a choice between single character or all characters on the account. The "all characters on the account" paradigm is no more. All permissions are granted per character.

Overview:


Process:
  1. To begin, visit the Dashboard
  2. Use the EVE SSO button to login as your MAIN character.
  3. When you are returned to the Dashboard, you will see a message stating you are logged in, your character name, and your in-game portrait.

    At this point you'll want to press the +Link button at the bottom of the page. This starts the process of creating a new Auth Token and linking it to your main character.
  4. On the Auth site, (you will still be logged into the Dashboard as your main character) notice how the EVE SSO Login button is not surrounded by the red reminder boxes. Press the SSO Login button.
  5. Here on the Eve SSO page once again, you'll want to select one of your characters you have not yet linked to your main. Use the drop-down box at the top to change characters, and the scroll all the way to the bottom. Press the Authorize button.
  6. When you are returned to the Auth Gizmo, you will see a message stating you are logged in, your character name, and your in-game portrait.

    At this point you'll want to press the +Link button at the bottom of the page. This will lead to you to the confirmation page.
  7. The confirmation page will show you which characters are about to be linked. Press the confirm button.
  8. Back on the Dashboard homepage you will now see the character you selected on the Auth Gizmo linked to your main. You'll want to repeat steps 3 - 7 for each character. You must also do this for your main. Yes you link yourself to yourself. screwy, ain't it?


Troubleshooting:
Sometimes something goes wrong.


Known Issues
#1
There's a known issue on step 5. When you are ready to switch over to another account, the EVE SSO page seems to automatically log you in instead of asking for your account/password. When this happens, scroll to the bottom of the page and hit the Cancel button. Afterwards, visit the Dashboard again to start the process over. You should be asked for login credentials this time when you get to step 5.

#2
You need to make sure you have the two-factor logins disabled when added these Auth Tokens. It won't work when enabled. Visit the Accounts page to disable it temporarily.


Example Session:
Howto login a main and Link it's Auth Token.

In today's space adventure a new player has joined corp and is adding his Auth Token to the MNDS Dashboard.

We'll get started by logging in with our main character and linking it's own auth token.

  • Dashboard
    The MNDS Dashboard
  • EVE Login
    EVE Login Page
  • Authorize
    Main Character Selection
  • Logged In
    Main Logged In, No Linked Auths
  • ESI Auth
    Auth Gizmo Main Page
  • EVE Login Again
    Eve Login Page Again
  • Authorize ESI
    Main Character Selected Again
  • Authorized Scopes
    Press Authorize under the Scopes List.
  • Time to Link Auth
    Back on the Auth Gizmo Logged In.
  • Confirm Link Auth
    The Link Auth confirmation page.
  • Auth Linked
    Success! First Auth Linked!

The remaining characters are added in the same way. Done forget to read about the login problem work-around in the troubleshooting section.


FAQs:
wtf is going on here?


Should I delete my old-style API keys on the Corp and/or Alliance websites?
HELL NO! Leave them in place until June.

Why is this being done?
The XMLAPI server cannot keep up with the load and it’s very old technology. Also, it does not have data for the new Upwell structures.

Are these mandatory?
Yes

Which characters need to be added?
All of your Imperium characters. Also if you have a neutral alt that conducts official corp business, it must be added as well.

What about my alt-corp characters?
All of your Imperium characters. Imperium alt-corp characters too. We are not concerned with your hi-sec alt-corp's characters (unless they conduct official Mindstar business). However, we reserve the right to require an Auth Token for one of these neutral characters should shenanigans happen or foul play need to be investigated.

Where can I found out more?


Hi Fish!