User Cipher Uses

A UserCipherUse is a way to see the exact set of encryption ciphers and protocols used by a given user. This is most often used to support migrations from one TLS version to the next. You can query each user and determine who is still using legacy ciphers.

List User Cipher Uses

SDK Method

UserCipherUse.List();

Return Object

FilesList<UserCipherUse>

Authorization Requirement

Not available to user API keys or sessions from users that are marked as Shared/Bot users.

Method Arguments

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

Additional Arguments

Example Request

using FilesCom.Models;

var parameters = new Dictionary<string, object>();
parameters.Add("user_id", (Int64?) 1);

try
{
    var userCipherUseIterator = UserCipherUse.List(parameters);
    foreach (UserCipherUse userCipherUse in userCipherUseIterator.ListAutoPaging()) {
        // Operate on userCipherUse
    }
}
catch (FilesCom.NotAuthenticatedException e)
{
    Console.WriteLine($"Authentication Error Occurred ({e.GetType().Name}): " + e.Message);
}
catch (FilesCom.SdkException e)
{
    Console.WriteLine($"Unknown Error Occurred ({e.GetType().Name}): " + e.Message);
}

The UserCipherUse Object

Some of the methods above return a UserCipherUse object. The attributes of this object are listed below.

AttributeDescription
id
int64		UserCipherUse ID
user_id
int64		ID of the user who performed this access
username
string		Username of the user who performed this access
protocol_cipher
string		The protocol and cipher employed
created_at
date-time		The earliest recorded use of this combination of interface and protocol and cipher (for this user)
insecure
boolean		Is this cipher considered insecure?
interface
string		The interface accessed
Possible values: web, ftp, sftp, dav, desktop, restapi, robot, jsapi, inbound_s3
updated_at
date-time		The most recent use of this combination of interface and protocol and cipher (for this user)