Skip to content

Commit

Permalink
feat(docs): ssa lifetime docs updated (#7172)
Browse files Browse the repository at this point in the history
Signed-off-by: Milton Ch <j.milton.chambi.m@gmail.com>
Signed-off-by: Yuriy Movchan <Yuriy.Movchan@gmail.com>
  • Loading branch information
Milton-Ch authored and yurem committed Jan 1, 2024
1 parent 0d481ca commit 846e2a5
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 6 deletions.
10 changes: 5 additions & 5 deletions docs/admin/auth-server/endpoints/ssa.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ Create `SSA` for the organization with `expiration` (optional).
| expiration | Expiration date. `(Default value: calculated based on global SSA settings)` | true |
| one_time_use | Defined whether the SSA will be used only once or can be used multiple times. `(Default value: true)` | true |
| rotate_ssa | TODO - Will be used to rotate expiration of the SSA, currently is only saved as part of the SSA. `(Default value: true)` | true |
| lifetime | SSA Lifetime in milliseconds | true |
| lifetime | SSA Lifetime in seconds | true |

**Note:** You can add more `custom attributes` in the request, (you must have previously configured in the SSA global
configuration).
Expand Down Expand Up @@ -136,7 +136,7 @@ Returned SSA is a JWT, containing the following structure:
- `org_id` — The "org_id" is used for organization identification.
- `software_roles` — List of string values, fixed value `["password", "notify"]`.
- `grant_types` — Fixed value `["client_credentials"]`.
- `lifetime` — SSA lifetime in milliseconds.
- `lifetime` — SSA lifetime in seconds.
- `exp` — Expiration Time.
- `myCustom1, myCustom2, ...`: if you have custom attributes, they will be displayed here.

Expand Down Expand Up @@ -238,7 +238,7 @@ Get existing active SSA based on `jti` or `org_id`.
- `description` — Describe SSA.
- `one_time_use` — Defined whether the SSA will be used only once or can be used multiple times.
- `rotate_ssa` — TODO - Will be used to rotate expiration of the SSA, currently is only saved as part of the SSA.
- `lifetime` — SSA lifetime in milliseconds.
- `lifetime` — SSA lifetime in seconds.
- `myCustom1, myCustom2, ...` — if you have custom attributes, they will be displayed here.
- `iss` — The "iss" is related to the client that created this SSA.
- `created_at` — Creation time.
Expand Down Expand Up @@ -528,10 +528,10 @@ The SSA entity contains the following fields:
- `creationDate` type `Date` — SSA Creation date.
- `creatorId` type `String` — Client that created SSA.
- `creatorType` type enum `CreatorType` — Contains the following CreatorType values (`NONE`, `CLIENT`, `USER`, `AUTO`).
- `ttl` type `Integer` — SSA lifetime in milliseconds.
- `ttl` type `Integer` — SSA lifetime in seconds.
- `atributes` type class `SsaAtributes`
- `oneTimeUse` type `Boolean` — Whether the SSA will be single use.
- `lifetime` type `Integer` — SSA lifetime in milliseconds.
- `lifetime` type `Integer` — SSA lifetime in seconds.
- `rotateSsa` type `Boolean` — TODO - Will be used to rotate expiration of the SSA, currently is only saved as part
of the SSA.
- `clientDn` type `String` — Client's DN.
Expand Down
2 changes: 1 addition & 1 deletion jans-auth-server/docs/swagger.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4247,7 +4247,7 @@ paths:
default: true
lifetime:
type: integer
description: SSA lifetime in milliseconds.
description: SSA lifetime in seconds.
example: 86400
responses:
201:
Expand Down

0 comments on commit 846e2a5

Please sign in to comment.