Signing in and out#
Applies to v0.9Last reviewed
In short
Zymcos does not keep your password: you sign in on a page run by Zynth Auth, and Zymcos then starts a session. This page says how a session starts, how long it lasts, what ends it and what you see when something goes wrong.
Zymcos does not keep your password. You sign in on a page run by Zynth Auth, and Zymcos then starts a session for you: the period during which the workspace recognises you without asking again. This page says how a session starts, how long it lasts, what ends it, and what you see when something goes wrong.
Signing in#
Open Zymcos in your browser. If you are not signed in, it sends you to Zynth Auth by itself; there is no separate sign-in button to find. When you have signed in, you come back to the page you were opening, on the same production, rather than to a start page.
If the sign-in does not complete, Zymcos shows a page headed Sign-in did not complete, says in a sentence what happened, and offers Try again. The sentence is one of these:
- Zynth Auth declined the sign-in. If you cancelled, try again.
- Zynth Auth could not be reached. That is an outage, not a wrong password; try again shortly.
- Zynth Auth signed you in, but Zymcos could not start your session because its session service is unavailable. Also an outage on our side; try again shortly.
- The sign-in took too long and expired. A sign-in has ten minutes to finish; start again.
- The sign-in could not be matched to the one that started it. This usually means a stale tab; start again from that page.
- Your organisation's installation of Zymcos does not allow everything it needs to sign you in. Trying again will not help: an administrator of your organisation has to widen the permissions given to the application in Zynth Auth.
If you are signed in but see a message that your account has no workspace yet, signing in worked and a workspace has not been set up for you. Once it is, sign out and back in to pick it up.
How long a session lasts#
A session lasts at most 12 hours from the moment you sign in, however busy you are. It is not extended by activity: at the end of the 12 hours you sign in again, and the new session gets a new 12 hours.
While the session lasts, Zymcos keeps you signed in behind the scenes. As you work, it renews the permission it holds for you with Zynth Auth just before that permission runs out, so you are not asked again in the middle of a working day. If Zynth Auth cannot be reached at that moment but your current permission is still good, you carry on; only when it has run out and cannot be renewed does Zymcos stop, and then it tells you the service is unavailable (below) rather than signing you out.
If Zymcos finds that the permission it holds ran out a moment before it expected, it renews it and repeats what you asked once, so you do not see an error for it. The one thing it cannot repeat is a file you were uploading: that shows the usual failure message, and pressing it again works.
What ends a session early#
- You sign out (below).
- Access is withdrawn. If your access to Zymcos is taken away in Zynth Auth, the next renewal is refused and the session ends.
- You sign out of Zynth Auth elsewhere. Zynth Auth tells Zymcos, and every session that sign-in started here is ended at once.
- The session service restarts. Sessions are held in a service that is restarted by some maintenance releases, which signs everyone out once. The release notes say so when it happens. Signing in again is all it takes.
Signing out#
The Sign out button is at the right of the top barSettings and Sign out in the top bar
Signing out does not cancel a take that was already being made. The take finishes on our side and is filed in the production, and it is there when you sign in again.
When a session ends while a page is open#
A tab you left open keeps showing what it had. When you come back to it, and it has been more than half a minute since it last checked, the page asks again. If the session has ended it takes you to Zynth Auth to sign in and then brings you back to the same page.
If you press something in the moment between the session ending and the page noticing, the action is refused and the message says nothing was saved. Reload the page, sign in, and do it again. A message you had typed to CODA and not yet sent is not kept across a sign-in, so copy anything long before you go looking for the cause.
"Zymcos is temporarily unavailable"#
If the service that holds sessions cannot be reached, or your browser cannot reach Zymcos at all, you see a page headed Zymcos is temporarily unavailable. It says:
- You are still signed in, and nothing you made is lost. This is not a sign-out.
- The page comes back by itself when the service does. It asks again every five seconds, on the same address you were on.
- Try again asks at once.
You do not need to sign in again, and there is nothing to do but wait or press Try again. If it stays for long, tell support and say what time it began.
Phones#
Once you have signed in on a phone, Zymcos shows the workspace one panel at a time, with CODA, Workspace and Details at the footThe bar at the foot of a phone