FIfiles
users
User Cipher Uses

List User Cipher Uses

Changed on

List User Cipher Uses

get/users/{user_id}/cipher_uses

Request

  • Base URL
    https://app.files.com/api/rest/v1
  • URL
    https://app.files.com/api/rest/v1/users/{user_id}/cipher_uses
  • Auth
    none declared

Path parameters

user_idinteger required

User ID. If provided, will return uses for this user.

Query parameters

cursorstring

Used for pagination. When a list request has more records available, cursors are provided in the response headers X-Files-Cursor-Next and X-Files-Cursor-Prev. Send one of those cursor value here to resume an existing list from the next available record. Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.

per_pageinteger

Number of records to show per page. (Max: 10000, 1,000 or less is recommended).

If set, sort records by the specified field in either asc or desc direction. Valid fields are updated_at.

If set, return records where the specified field is equal to the supplied value. Valid fields are insecure and updated_at. Valid field combinations are [ insecure, updated_at ].

If set, return records where the specified field is greater than the supplied value. Valid fields are updated_at.

If set, return records where the specified field is greater than or equal the supplied value. Valid fields are updated_at.

If set, return records where the specified field is less than the supplied value. Valid fields are updated_at.

If set, return records where the specified field is less than or equal the supplied value. Valid fields are updated_at.

Response

A list of UserCipherUses objects.

idinteger

UserCipherUse ID

user_idinteger

ID of the user who performed this access

usernamestring

Username of the user who performed this access

protocol_cipherstring

The protocol and cipher employed

created_atstring date-time

The earliest recorded use of this combination of interface and protocol and cipher (for this user)

insecureboolean

Is this cipher considered insecure?

interface'web' | 'ftp' | 'sftp' | 'dav' | 'desktop' | 'restapi' | 'robot' | 'jsapi' | 'inbound_s3'

The interface accessed

updated_atstring date-time

The most recent use of this combination of interface and protocol and cipher (for this user)

Example response

[
  {
    "id": 1,
    "user_id": 1,
    "username": "example",
    "protocol_cipher": "TLSv1.2; ECDHE-RSA-AES256-GCM-SHA384",
    "created_at": "2000-01-01T01:00:00Z",
    "insecure": true,
    "interface": "restapi",
    "updated_at": "2000-01-01T01:00:00Z"
  }
]

Changes

  • e20172733728Revision changes
    • info

      added the new optional query request parameter filter

    • info

      added the new optional query request parameter filter_gt

    • info

      added the new optional query request parameter filter_gteq

    • info

      added the new optional query request parameter filter_lt

    • info

      added the new optional query request parameter filter_lteq

    • info

      added the new optional query request parameter sort_by

  • 3bb8c8a06041Revision changes
    • info

      api tag User Cipher Uses added