Skip to content

SecurityGroupSettings

Source code in docs_src/capo_wickr/types/security_group_settings.py
class SecurityGroupSettings(TypedDict, closed=True):
    always_reauthenticate: NotRequired["bool"]
    """<p>Requires users to reauthenticate every time they return to the application, providing an additional layer of security.</p>"""
    atak_package_values: NotRequired[
        "capo_wickr.types.security_group_string_list.SecurityGroupStringList"
    ]
    """<p>Configuration values for ATAK (Android Team Awareness Kit) package integration, when ATAK is enabled.</p>"""
    calling: NotRequired["capo_wickr.types.calling_settings.CallingSettings"]
    """<p>The calling feature permissions and settings that control what types of calls users can initiate and participate in.</p>"""
    check_for_updates: NotRequired["bool"]
    """<p>Enables automatic checking for Wickr client updates to ensure users stay current with the latest version.</p>"""
    enable_atak: NotRequired["bool"]
    """<p>Enables ATAK (Android Team Awareness Kit) integration for tactical communication and situational awareness.</p>"""
    enable_crash_reports: NotRequired["bool"]
    """<p>Allow users to report crashes.</p>"""
    enable_file_download: NotRequired["bool"]
    """<p>Specifies whether users can download files from messages to their devices.</p>"""
    enable_guest_federation: NotRequired["bool"]
    """<p>Allows users to communicate with guest users from other Wickr networks and federated external networks.</p>"""
    enable_notification_preview: NotRequired["bool"]
    """<p>Enables message preview text in push notifications, allowing users to see message content before opening the app.</p>"""
    enable_open_access_option: NotRequired["bool"]
    """<p> Allow users to avoid censorship when they are geo-blocked or have network limitations.</p>"""
    enable_restricted_global_federation: NotRequired["bool"]
    """<p>Enables restricted global federation, limiting external communication to only specified permitted networks.</p>"""
    files_enabled: NotRequired["bool"]
    """<p>Enables file sharing capabilities, allowing users to send and receive files in conversations.</p>"""
    force_device_lockout: NotRequired["int"]
    """<p> Defines the number of failed login attempts before data stored on the device is reset. Should be less than lockoutThreshold.</p>"""
    force_open_access: NotRequired["bool"]
    """<p>Automatically enable and enforce Wickr open access on all devices. Valid only if enableOpenAccessOption settings is enabled.</p>"""
    force_read_receipts: NotRequired["bool"]
    """<p>Allow user approved bots to read messages in rooms without using a slash command.</p>"""
    global_federation: NotRequired["bool"]
    """<p>Allows users to communicate with users on other Wickr instances (Wickr Enterprise) outside the current network.</p>"""
    is_ato_enabled: NotRequired["bool"]
    """<p>Enforces a two-factor authentication when a user adds a new device to their account.</p>"""
    is_link_preview_enabled: NotRequired["bool"]
    """<p>Enables automatic preview of links shared in messages, showing webpage thumbnails and descriptions.</p>"""
    location_allow_maps: NotRequired["bool"]
    """<p>Allows map integration in location sharing, enabling users to view shared locations on interactive maps. Only allowed when location setting is enabled.</p>"""
    location_enabled: NotRequired["bool"]
    """<p>Enables location sharing features, allowing users to share their current location with others.</p>"""
    max_auto_download_size: NotRequired["int"]
    """<p>The maximum file size in bytes that will be automatically downloaded without user confirmation. Only allowed if fileDownload is enabled. Valid Values [512000 (low_quality), 7340032 (high_quality) ]</p>"""
    max_bor: NotRequired["int"]
    """<p>The maximum burn-on-read (BOR) time in seconds, which determines how long messages remain visible before auto-deletion after being read.</p>"""
    max_ttl: NotRequired["int"]
    """<p>The maximum time-to-live (TTL) in seconds for messages, after which they will be automatically deleted from all devices.</p>"""
    message_forwarding_enabled: NotRequired["bool"]
    """<p>Enables message forwarding, allowing users to forward messages from one conversation to another.</p>"""
    password_requirements: NotRequired[
        "capo_wickr.types.password_requirements.PasswordRequirements"
    ]
    """<p>The password complexity requirements that users must follow when creating or changing passwords.</p>"""
    presence_enabled: NotRequired["bool"]
    """<p>Enables presence indicators that show whether users are online, away, or offline.</p>"""
    quick_responses: NotRequired[
        "capo_wickr.types.security_group_string_list.SecurityGroupStringList"
    ]
    """<p>A list of pre-defined quick response message templates that users can send with a single tap.</p>"""
    show_master_recovery_key: NotRequired["bool"]
    """<p>Users will get a master recovery key that can be used to securely sign in to their Wickr account without having access to their primary device for authentication. Available in SSO enabled network.</p>"""
    shredder: NotRequired["capo_wickr.types.shredder_settings.ShredderSettings"]
    """<p>The message shredder configuration that controls secure deletion of messages and files from devices.</p>"""
    sso_max_idle_minutes: NotRequired["int"]
    """<p>The duration for which users SSO session remains inactive before automatically logging them out for security. Available in SSO enabled network.</p>"""
    max_non_sso_session_minutes: NotRequired["int"]
    """<p>Maximum session duration in minutes for non-SSO users. Set to 0 to disable. Valid range is 60 to 525600 (1 hour to 365 days).</p>"""
    federation_mode: NotRequired["int"]
    """<p>The local federation mode controlling how users can communicate with other networks. Values: 0 (none), 1 (federated), 2 (restricted).</p>"""
    lockout_threshold: NotRequired["int"]
    """<p>The number of failed password attempts before a user account is locked out.</p>"""
    permitted_networks: NotRequired[
        "capo_wickr.types.permitted_networks_list.PermittedNetworksList"
    ]
    """<p>A list of network IDs that are permitted for local federation when federation mode is set to restricted.</p>"""
    permitted_wickr_aws_networks: NotRequired[
        "capo_wickr.types.wickr_aws_networks_list.WickrAwsNetworksList"
    ]
    """<p>A list of permitted Wickr networks for global federation, restricting communication to specific approved networks.</p>"""
    permitted_wickr_enterprise_networks: NotRequired[
        "capo_wickr.types.permitted_wickr_enterprise_networks_list.PermittedWickrEnterpriseNetworksList"
    ]
    """<p>A list of permitted Wickr Enterprise networks for global federation, restricting communication to specific approved networks.</p>"""

always_reauthenticate instance-attribute

always_reauthenticate: NotRequired[bool]

Requires users to reauthenticate every time they return to the application, providing an additional layer of security.

atak_package_values instance-attribute

atak_package_values: NotRequired[SecurityGroupStringList]

Configuration values for ATAK (Android Team Awareness Kit) package integration, when ATAK is enabled.

calling instance-attribute

calling: NotRequired[CallingSettings]

The calling feature permissions and settings that control what types of calls users can initiate and participate in.

check_for_updates instance-attribute

check_for_updates: NotRequired[bool]

Enables automatic checking for Wickr client updates to ensure users stay current with the latest version.

enable_atak instance-attribute

enable_atak: NotRequired[bool]

Enables ATAK (Android Team Awareness Kit) integration for tactical communication and situational awareness.

enable_crash_reports instance-attribute

enable_crash_reports: NotRequired[bool]

Allow users to report crashes.

enable_file_download instance-attribute

enable_file_download: NotRequired[bool]

Specifies whether users can download files from messages to their devices.

enable_guest_federation instance-attribute

enable_guest_federation: NotRequired[bool]

Allows users to communicate with guest users from other Wickr networks and federated external networks.

enable_notification_preview instance-attribute

enable_notification_preview: NotRequired[bool]

Enables message preview text in push notifications, allowing users to see message content before opening the app.

enable_open_access_option instance-attribute

enable_open_access_option: NotRequired[bool]

Allow users to avoid censorship when they are geo-blocked or have network limitations.

enable_restricted_global_federation instance-attribute

enable_restricted_global_federation: NotRequired[bool]

Enables restricted global federation, limiting external communication to only specified permitted networks.

federation_mode instance-attribute

federation_mode: NotRequired[int]

The local federation mode controlling how users can communicate with other networks. Values: 0 (none), 1 (federated), 2 (restricted).

files_enabled instance-attribute

files_enabled: NotRequired[bool]

Enables file sharing capabilities, allowing users to send and receive files in conversations.

force_device_lockout instance-attribute

force_device_lockout: NotRequired[int]

Defines the number of failed login attempts before data stored on the device is reset. Should be less than lockoutThreshold.

force_open_access instance-attribute

force_open_access: NotRequired[bool]

Automatically enable and enforce Wickr open access on all devices. Valid only if enableOpenAccessOption settings is enabled.

force_read_receipts instance-attribute

force_read_receipts: NotRequired[bool]

Allow user approved bots to read messages in rooms without using a slash command.

global_federation instance-attribute

global_federation: NotRequired[bool]

Allows users to communicate with users on other Wickr instances (Wickr Enterprise) outside the current network.

is_ato_enabled instance-attribute

is_ato_enabled: NotRequired[bool]

Enforces a two-factor authentication when a user adds a new device to their account.

is_link_preview_enabled: NotRequired[bool]

Enables automatic preview of links shared in messages, showing webpage thumbnails and descriptions.

location_allow_maps instance-attribute

location_allow_maps: NotRequired[bool]

Allows map integration in location sharing, enabling users to view shared locations on interactive maps. Only allowed when location setting is enabled.

location_enabled instance-attribute

location_enabled: NotRequired[bool]

Enables location sharing features, allowing users to share their current location with others.

lockout_threshold instance-attribute

lockout_threshold: NotRequired[int]

The number of failed password attempts before a user account is locked out.

max_auto_download_size instance-attribute

max_auto_download_size: NotRequired[int]

The maximum file size in bytes that will be automatically downloaded without user confirmation. Only allowed if fileDownload is enabled. Valid Values [512000 (low_quality), 7340032 (high_quality) ]

max_bor instance-attribute

max_bor: NotRequired[int]

The maximum burn-on-read (BOR) time in seconds, which determines how long messages remain visible before auto-deletion after being read.

max_non_sso_session_minutes instance-attribute

max_non_sso_session_minutes: NotRequired[int]

Maximum session duration in minutes for non-SSO users. Set to 0 to disable. Valid range is 60 to 525600 (1 hour to 365 days).

max_ttl instance-attribute

max_ttl: NotRequired[int]

The maximum time-to-live (TTL) in seconds for messages, after which they will be automatically deleted from all devices.

message_forwarding_enabled instance-attribute

message_forwarding_enabled: NotRequired[bool]

Enables message forwarding, allowing users to forward messages from one conversation to another.

password_requirements instance-attribute

password_requirements: NotRequired[PasswordRequirements]

The password complexity requirements that users must follow when creating or changing passwords.

permitted_networks instance-attribute

permitted_networks: NotRequired[PermittedNetworksList]

A list of network IDs that are permitted for local federation when federation mode is set to restricted.

permitted_wickr_aws_networks instance-attribute

permitted_wickr_aws_networks: NotRequired[WickrAwsNetworksList]

A list of permitted Wickr networks for global federation, restricting communication to specific approved networks.

permitted_wickr_enterprise_networks instance-attribute

permitted_wickr_enterprise_networks: NotRequired[PermittedWickrEnterpriseNetworksList]

A list of permitted Wickr Enterprise networks for global federation, restricting communication to specific approved networks.

presence_enabled instance-attribute

presence_enabled: NotRequired[bool]

Enables presence indicators that show whether users are online, away, or offline.

quick_responses instance-attribute

quick_responses: NotRequired[SecurityGroupStringList]

A list of pre-defined quick response message templates that users can send with a single tap.

show_master_recovery_key instance-attribute

show_master_recovery_key: NotRequired[bool]

Users will get a master recovery key that can be used to securely sign in to their Wickr account without having access to their primary device for authentication. Available in SSO enabled network.

shredder instance-attribute

shredder: NotRequired[ShredderSettings]

The message shredder configuration that controls secure deletion of messages and files from devices.

sso_max_idle_minutes instance-attribute

sso_max_idle_minutes: NotRequired[int]

The duration for which users SSO session remains inactive before automatically logging them out for security. Available in SSO enabled network.