Silverfort

Use the Silverfort integration to get and update Silverfort risk severity.

Authentication & Identity Management · Silverfort

Details

IDSilverfort
ProviderSilverfort
CategoryAuthentication & Identity Management
From Version5.0.0
Docker Imagedemisto/auth-utils:1.0.0.10133006
Supported ModulesAgentix XSIAM

README

Silverfort protects organizations from data breaches by delivering strong authentication across entire corporate networks and cloud environments, without requiring any modifications to endpoints or servers. Using patent-pending technology, Silverfort’s agentless approach enables multi-factor authentication and AI-driven adaptive authentication even for systems that don’t support it today, including proprietary systems, critical infrastructure, shared folders, IoT devices, and more.

Use Silverfort integration to get & update Silverfort risk severity.

This integration was integrated and tested with Silverfort version 5.2.

Silverfort Playbook


  • Get risk information and block the user if the risk is ‘high’ or ‘critical’
  • Update the Silverfort user risk level

Use Cases


  • Consume Silverfort user and server risk levels
  • Enrich the Silverfort risk engine and trigger MFA on risky entities

Configure Silverfort in Cortex

Parameter Description Required
Name a textual name for the integration instance True
url Server URL True
apikey APIKEY True
insecure Trust any certificate (not secure) False
  • To generate an API token for external access:
    1. On the Silverfort Admin Console, navigate to the SETTINGS page, and then select Silverfort API.
    2. Enable the Allow 3rd party risk updates switch.
    3. Copy the Risk API Key (External Access) value - this will be your API key.
    4. For the URL, use one of the following based on your Silverfort region:
      • Global region: https://raven.silverfort.io
      • EU region: https://eu.raven.silverfort.io
      • Singapore region: https://sg.raven.silverfort.io
        // End of Selection

For more information, see the Silverfort documentation.

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details. DBot messages provide a structured summary of the command execution, including the inputs, outputs, and any relevant indicators of compromise (IOCs) or risk levels.

silverfort-get-user-risk


User risk commands - get the user entity risk.

Base Command

silverfort-get-user-risk

Input

Argument Name Description Required
upn The user principal name. Optional
email The email address. Optional
sam_account The sam account. Optional
domain The domain. Optional

Specify one of the following:

  • upn
  • email address and domain
  • sam account and domain

Context Output

Path Type Description
Silverfort.UserRisk.Risk String The risk level.
Silverfort.UserRisk.Reasons Unknown The reasons for the risk.
Silverfort.UserRisk.UPN String The user principal name.

Command Example

!silverfort-get-user-risk upn="sfuser@silverfort.io"

Human Readable Output

Silverfort User Risk

UPN Risk Reasons
sfuser@silverfort.io Medium Suspicious activity, Password never expires

silverfort-get-resource-risk


Gets the resource entity risk information.

Base Command

silverfort-get-resource-risk

Input

Argument Name Description Required
resource_name The hostname. Required
domain_name The domain. Required

Command Example

!silverfort-get-resource-risk resource_name="SF-DC-1" domain_name="silverfort.io"

Human Readable Output

Silverfort Resource Risk

ResourceName Risk Reasons
SF-DC-1 Low Unconstrained Delegation

silverfort-update-user-risk


Updates the user entity risk.

Base Command

silverfort-update-user-risk

Input

Argument Name Description Required
upn The user principal name. Optional
risk_name The risk name. Required
severity The severity. Required
valid_for The number of hours that the risk will be valid for. Required
description The risk description. Required

Command Example

!silverfort-update-user-risk upn="sfuser@silverfort.io" risk_name="activity_risk" severity=medium valid_for=1 description="Suspicious activity"

Human Readable Output

ok

silverfort-update-resource-risk


Update the resource entity risk.

Base Command

silverfort-update-resource-risk

Input

Argument Name Description Required
resource_name The hostname. Required
domain_name The domain name. Required
risk_name The risk name. Required
severity The severity. Required
valid_for The number of hours the severity will be relevant for. Required
description A short description about the risk. Required

Command Example

!silverfort-update-resource-risk resource_name="SF-DC-1" domain_name="silverfort.io" risk_name="malware_risk" severity="high" valid_for=1 description="Malware detected"

Human Readable Output

ok

Configuration parameters

  • url — Server URL (required)
  • apikey — APIKEY (required)
  • insecure — Trust any certificate (not secure)
  • operationalApiKey — Operational API Key
  • externalApiKey — External API Key

Commands (4)

  • silverfort-get-resource-risk

    Gets the resource entity risk information.

  • silverfort-get-user-risk

    User risk commands - get the user entity risk.

  • silverfort-update-resource-risk

    Update the resource entity risk.

  • silverfort-update-user-risk

    Updates the user entity risk.

## Silverfort Integration
- To use this integration you need to enter the **Server URL** ,**API Key** parameters. 
- To create **API Key**:
    1. Next to the Silverfort Admin Console, navigate to the **SETTINGS** page, and then select **Silverfort API**.
    2. At the Application **User ID** field, click **Create App User**.
    3. Copy the values of the **App User ID** and **App User Secret**.
    4. Click Save all.
    5. The API KEY is "**App USer ID**:**App USer Secret**".(note the ":" between the User ID and the Secret)
    
For more information, see the [Silverfort documentation](https://support.silverfort.com/hc/en-us/articles/360020891537-Silverfort-Risk-Engine-API-Reference).