Platform class - Platform - BlueCat Gateway - 21.11.2

Gateway Administration Guide

Locale
English
Product name
BlueCat Gateway
Version
21.11.2

class bluecat.gateway.platform.Platform(env:bluecat.gateway.internal.environment.Environment)

Bases: bluecat.gateway.internal.platform.Platform

Class representing the supported operations with the Gateway Platform.

Gateway runs an enhanced Flask application. The recommended way for accessing the platform instance is via flask.current_app.platform.

Note: All read operations consider the platform workspaces and whether the default workspace is included in the resolution, is configurable.All write operations are performed in the custom workspace only.

New in version 20.12.1.

decrypt_value_from_file(path:str, key:str, *, scan_default:bool=False)

Decrypt the contents of a file located in a workspace of the platform.

Parameters Description
path(str) Path to an encrypted file, relative to a workspace of the platform.
key(str) Key to use for decrypting.
scan_default(bool, optional) Whether the default workspace to be inspected when resolving the file. Defaults to False.

Returns: Decrypted value.

Return type: str

New in version 20.12.1.

encrypt_value_to_file(path:str, value:str, key:str)

Encrypt a value and store it in a file located in a workspace of the platform.

Parameters Description
path(str) Path to where an encrypted file should be created. It is relative to a workspace of the platform.
value(str) Value to encrypt and store.
key(str) Key to use for encrypting.

New in version 20.12.1.

get_path_for_writing(path:str)

Return a path that can be used for creating files that are addressable via a path relative to a platform workspace.

Parameters Description
path(str) Path relative to a platform workspace.

Returns: Full path to a location inside the writable workspace.

Return type: str

Note: There is no guarantee that the path is immediately writable. Intermediate directories may have to be created. Alternatively, the permissions of existing directories may prevent write operations.

New in version 20.12.1.

resolve_existing_path(path:str, *, scan_default:bool=False)

Validate the path against the contents of the platform workspaces and return a full path to the resource. The returned value contains the path of a workspace. The validation consists of checking that the path exists.

Parameters Description
path(str) Path relative to a platform workspace.
scan_default(bool, optional) Whether the default workspace to be inspected as well. Defaults to False.

Raises: ResourceError – If the path cannot be resolved.

Returns: Full path to the resource.

Return type: str

New in version 20.12.1.

safe_resolve_certificates_dir_path(path:str, *, scan_default:bool=False)

Validate the path against the contents of the platform workspaces and return a full path to the resource. The returned value contains the path of a workspace. The validation consists of checking that the path is an existing folder with files.

Parameters Description
path(str) Path relative to a platform workspace.
scan_default(bool, optional) Whether the default workspace to be inspected as well. Defaults to False.

Returns: Full path to the resource. Returns None if the path cannot be resolved.

Return type: Optional[str]

New in version 20.12.1.

safe_resolve_existing_path(path:str, *, scan_default:bool=False)

Validate the path against the contents of the platform workspaces and return a full path to the resource. The returned value contains the path of a workspace. The validation consists of checking that the path exists.

Parameters Description
path(str) Path relative to a platform workspace.
scan_default(bool, optional) Whether the default workspace to be inspected as well. Defaults to False.

Returns: Full path to the resource. Returns None if the path cannot be resolved.

Return type: Optional[str]

New in version 20.12.1.