shufflepy 0.1.3

Use Shufflepy to control Shuffle and Singul

Shufflepy

Connect to your favorite services with a Singul line of code.

This Library is in an Experimental Phase, released under pypi

Installation

pip install shufflepy

Configuration

from shufflepy import Singul 

## If the config is not specified, the library will use `https://shuffler.io` as the default URL. You must specify an apikey. 

singul = Singul(
	"APIKEY",
	url='https://shuffler.io',
)

Requirements

• An API-key for Shuffle
• Having an active authentication for the service you are trying to connect to in Shuffle, whether in your own instance or in the Shuffle cloud: https://shuffler.io. This will be added to the future Shuffle CLI, and is also doable with the App Authentication API.
• If onprem: A Shuffle instance.

Usage

Sample functions below. If none of these match, try to use the shuffle.connect() function to run ANYTHING. By default returns the matching translation standard if available, otherwise the raw output.

singul.cases.create_ticket("jira", title="Title")
singul.communication.send_message("slack", message="Test")
singul.communication.send_message("teams", message="Test")
tickets = singul.cases.list_tickets("jira")

Normal App run control:

singul.run_app(app_id="bc78f35c6c6351b07a09b7aed5d29652", action="repeat_back_to_me", params={"call": "The value to repeat"})

Manual:

# General connect
resp = singul.cases.list_tickets(
	app="jira",
	org_id=os.environ.get("SHUFFLE_ORG_ID"),
	fields=[{
		"key": "max-amount",
		"value": "10"
	}]
)

print(resp)

# General transformer - Transforms from any data into a standard, e.g. "list_tickets"
sourcedata = [{"title": "Tickettitle", "id": "hiya"}]
tickets = singul.transform(sourcedata, "list_tickets") # (coming soon)

print(tickets)

Basic output for list_tickets:

[{
  "id": "P-123",
  "title": "Ticket 1"
},
{
  "id": "P-124",
  "title": "Ticket 2"
}]

See default standards - Standards are modifiable, and you will see your own standards on the File page in Shuffle.

Exploring usage

To look through past executions, see the execution debugger available on /workflows/debug

Available Apps & categories

• >2500 APIs: Search in Shuffle

Available Categories (May 2024)

• Ticket management (Cases)
• Communication/Email (Comms)
• SIEM (SIEM)
• EDR/XDR (Eradication)
• Asset Management (Assets)
• Identity (IAM)
• Threat Intel (Intel)
• Cloud Security (Cloud)