---
title: 'Authentication web service'
url: 'https://documentation.netstorming.net/single-sign-on/authentication-web-service'
markdown: 'https://documentation.netstorming.net/single-sign-on/authentication-web-service.md'
date: '2021-07-26'
description: 'Authentication web service This web service is devoted to generate login tokens that can be used to log in a TOWeRS system without entering credentials (more on how to use the token here). In order to perform the request, a client must provide: an API key which can be generated in a TOWeRS system…'
---

# Authentication web service

[](#)  [ Single Sign On ](https://documentation.netstorming.net/single-sign-on)      Authentication web service    

#### Authentication web service

This web service is devoted to generate login tokens that can be used to log in a TOWeRS system without entering credentials (more on how to use the token [here](https://documentation.netstorming.net/single-sign-on/login-with-token)).

In order to perform the request, a client must provide:

- an API key which can be generated in a TOWeRS system and put it in the Authorization header.
- either a set of credentials (actor, login) or a special code belonging to the user we need to log in the TOWeRS system

If the request is performed correctly, a token string will be returned.

##### Request

Method: POST

Url:

```
https://baseurl/EPYCS_API/sso_token_generator
```

Headers:

- Authorization: Basic APIKEY
- Content/Type: application/json

Body:

```
{
    "actor": "testactor",
    "login": "testlogin"
}
```

or

```
{
    "foreign_code": "code"
}
```

##### Response

```
eyuhweqwe.dncp923nq8ybn2840rcn20nc.2cn80bryc90y4bc0y34rc80y3br4cy34
```

---

## Navigation

- Parent: [Single Sign On](https://documentation.netstorming.net/single-sign-on.md)
- Previous: [Foreign code](https://documentation.netstorming.net/single-sign-on/foreign-code.md)
- Next: [Login with token](https://documentation.netstorming.net/single-sign-on/login-with-token.md)