AWS - Step Functions Enum
Last updated
Last updated
Learn & practice AWS Hacking:HackTricks Training AWS Red Team Expert (ARTE) Learn & practice GCP Hacking: HackTricks Training GCP Red Team Expert (GRTE)
AWS Step Functions एक वर्कफ़्लो सेवा है जो आपको कई AWS सेवाओं को सर्वरलेस वर्कफ़्लो में समन्वयित और व्यवस्थित करने की अनुमति देती है। AWS Step Functions का उपयोग करके, आप विभिन्न AWS सेवाओं जैसे AWS Lambda, Amazon S3, Amazon DynamoDB, और कई अन्य को चरणों की एक श्रृंखला में जोड़ने वाले वर्कफ़्लो को डिज़ाइन और चलाने के लिए कर सकते हैं। यह समन्वय सेवा एक दृश्य वर्कफ़्लो इंटरफ़ेस प्रदान करती है और state machine क्षमताएँ प्रदान करती है, जिससे आप JSON-आधारित Amazon States Language (ASL) का उपयोग करके वर्कफ़्लो के प्रत्येक चरण को एक घोषणात्मक तरीके से परिभाषित कर सकते हैं।
AWS Step Functions दो प्रकार के state machine workflows प्रदान करता है: Standard और Express।
Standard Workflow: यह डिफ़ॉल्ट वर्कफ़्लो प्रकार लंबे समय तक चलने वाली, टिकाऊ और ऑडिट करने योग्य प्रक्रियाओं के लिए डिज़ाइन किया गया है। यह exactly-once execution का समर्थन करता है, यह सुनिश्चित करता है कि कार्य केवल एक बार चलें जब तक कि पुनः प्रयास निर्दिष्ट न किए जाएं। यह उन वर्कफ़्लो के लिए आदर्श है जिन्हें विस्तृत निष्पादन इतिहास की आवश्यकता होती है और यह एक वर्ष तक चल सकता है।
Express Workflow: यह प्रकार उच्च मात्रा, छोटे समयावधि के कार्यों के लिए आदर्श है, जो पांच मिनट तक चलते हैं। वे at-least-once execution का समर्थन करते हैं, जो डेटा प्रोसेसिंग जैसे idempotent कार्यों के लिए उपयुक्त है। ये वर्कफ़्लो लागत और प्रदर्शन के लिए अनुकूलित होते हैं, निष्पादन, अवधि और मेमोरी उपयोग के आधार पर चार्ज करते हैं।
States state machines के आवश्यक इकाइयाँ हैं। वे एक वर्कफ़्लो के भीतर व्यक्तिगत चरणों को परिभाषित करते हैं, जो इसके प्रकार के आधार पर विभिन्न कार्यों को करने में सक्षम होते हैं:
Task: एक कार्य को निष्पादित करता है, अक्सर AWS सेवा जैसे Lambda का उपयोग करते हुए।
Choice: इनपुट के आधार पर निर्णय लेता है।
Fail/Succeed: निष्पादन को विफलता या सफलता के साथ समाप्त करता है।
Pass: इनपुट को आउटपुट में पास करता है या डेटा को इंजेक्ट करता है।
Wait: सेट समय के लिए निष्पादन में देरी करता है।
Parallel: समानांतर शाखाएँ आरंभ करता है।
Map: आइटम पर चरणों को गतिशील रूप से दोहराता है।
A Task state एक state machine द्वारा निष्पादित कार्य की एकल इकाई का प्रतिनिधित्व करता है। कार्य विभिन्न संसाधनों को आमंत्रित कर सकते हैं, जिसमें गतिविधियाँ, Lambda फ़ंक्शन, AWS सेवाएँ, या तृतीय-पक्ष APIs शामिल हैं।
Activities: कस्टम श्रमिक जिन्हें आप प्रबंधित करते हैं, लंबे समय तक चलने वाली प्रक्रियाओं के लिए उपयुक्त।
Resource: arn:aws:states:region:account:activity:name.
Lambda Functions: AWS Lambda फ़ंक्शंस को निष्पादित करता है।
Resource: arn:aws:lambda:region:account:function:function-name.
AWS Services: अन्य AWS सेवाओं के साथ सीधे एकीकृत करता है, जैसे DynamoDB या S3।
Resource: arn:partition:states:region:account:servicename:APIname.
HTTP Task: तृतीय-पक्ष APIs को कॉल करता है।
Resource field: arn:aws:states:::http:invoke. फिर, आपको API एंडपॉइंट कॉन्फ़िगरेशन विवरण प्रदान करना चाहिए, जैसे API URL, विधि, और प्रमाणीकरण विवरण।
The following example shows a Task state definition that invokes a Lambda function called HelloWorld:
A Choice state adds conditional logic to a workflow, enabling decisions based on input data. It evaluates the specified conditions and transitions to the corresponding state based on the results.
Comparison: प्रत्येक चयन नियम में एक तुलना ऑपरेटर शामिल होता है (जैसे, NumericEquals, StringEquals) जो एक इनपुट वेरिएबल की तुलना एक निर्दिष्ट मान या दूसरे वेरिएबल से करता है।
Next Field: Choice states End फ़ील्ड का समर्थन नहीं करते हैं, इसके बजाय, वे तुलना सत्य होने पर संक्रमण के लिए Next राज्य को परिभाषित करते हैं।
Example of Choice state:
A Fail state एक state machine के निष्पादन को रोकता है और इसे एक विफलता के रूप में चिह्नित करता है। इसका उपयोग एक त्रुटि नाम और एक कारण निर्दिष्ट करने के लिए किया जाता है, जो विफलता के बारे में विवरण प्रदान करता है। यह स्थिति टर्मिनल है, जिसका अर्थ है कि यह निष्पादन प्रवाह को समाप्त करती है।
A Succeed state सफलतापूर्वक निष्पादन को रोकता है। इसका उपयोग आमतौर पर तब किया जाता है जब कार्यप्रवाह सफलतापूर्वक पूरा होता है। इस स्थिति को Next फ़ील्ड की आवश्यकता नहीं होती है।
एक Pass स्थिति अपने इनपुट को बिना कोई कार्य किए या JSON स्थिति इनपुट को फ़िल्टर का उपयोग करके परिवर्तित किए बिना अपने आउटपुट में पास करती है, और फिर परिवर्तित डेटा को अगली स्थिति में पास करती है। यह परीक्षण और स्थिति मशीनों का निर्माण करने के लिए उपयोगी है, जिससे आप स्थिर डेटा को इंजेक्ट या परिवर्तित कर सकते हैं।
A Wait state delays the execution of the state machine for a specified duration. There are three primary methods to configure the wait time:
X Seconds: प्रतीक्षा करने के लिए निश्चित संख्या में सेकंड।
Absolute Timestamp: प्रतीक्षा करने के लिए एक सटीक समय।
Dynamic Wait: इनपुट के आधार पर SecondsPath या TimestampPath का उपयोग करके।
A Parallel state allows you to execute multiple branches of tasks concurrently within your workflow. Each branch runs independently and processes its own sequence of states. The execution waits until all branches complete before proceeding to the next state. Its key fields are:
Branches: समानांतर निष्पादन पथों को परिभाषित करने वाला एक ऐरे। प्रत्येक शाखा एक अलग राज्य मशीन है।
ResultPath: परिभाषित करता है कि (इनपुट में) शाखाओं के संयुक्त आउटपुट को कहाँ रखा जाए।
Retry and Catch: समानांतर राज्य के लिए त्रुटि प्रबंधन कॉन्फ़िगरेशन।
A Map state enables the execution of a set of steps for each item in an dataset. It's used for parallel processing of data. Depending on how you want to process the items of the dataset, Step Functions provides the following modes:
Inline Mode: Executes a subset of states for each JSON array item. Suitable for small-scale tasks with less than 40 parallel iterations, running each of them in the context of the workflow that contains the Map state.
Distributed Mode: Designed for large-scale parallel processing with high concurrency. Supports processing large datasets, such as those stored in Amazon S3, enabling a high concurrency of up 10,000 parallel child workflow executions, running these child as a separate child execution.
Step Functions also lets you manage workflow deployments through versions and aliases of state machines. A version represents a snapshot of a state machine that can be executed. Aliases serve as pointers to up to two versions of a state machine.
Versions: These immutable snapshots of a state machine are created from the most recent revision of that state machine. Each version is identified by a unique ARN that combines the state machine ARN with the version number, separated by a colon (arn:aws:states:region:account-id:stateMachine:StateMachineName:version-number). Versions cannot be edited, but you can update the state machine and publish a new version, or use the desired state machine version.
Aliases: These pointers can reference up to two versions of the same state machine. Multiple aliases can be created for a single state machine, each identified by a unique ARN constructed by combining the state machine ARN with the alias name, separated by a colon (arn:aws:states:region:account-id:stateMachine:StateMachineName:aliasName). Aliases enable routing of traffic between one of the two versions of a state machine. Alternatively, an alias can point to a single specific version of the state machine, but not to other aliases. They can be updated to redirect to a different version of the state machine as needed, facilitating controlled deployments and workflow management.
For more detailed information about ASL, check: Amazon States Language.
AWS Step Functions utilizes AWS Identity and Access Management (IAM) roles to control access to resources and actions within state machines. Here are the key aspects related to security and IAM roles in AWS Step Functions:
Execution Role: Each state machine in AWS Step Functions is associated with an IAM execution role. This role defines what actions the state machine can perform on your behalf. When a state machine transitions between states that interact with AWS services (like invoking Lambda functions, accessing DynamoDB, etc.), it assumes this execution role to carry out those actions.
Permissions: The IAM execution role must be configured with permissions that allow the necessary actions on other AWS services. For example, if your state machine needs to invoke AWS Lambda functions, the IAM role must have lambda:InvokeFunction permissions. Similarly, if it needs to write to DynamoDB, appropriate permissions (dynamodb:PutItem, dynamodb:UpdateItem, etc.) must be granted.
ReadOnlyAccess नीति सभी निम्नलिखित enumeration क्रियाओं के लिए पर्याप्त है।
In the following page, you can check how to Step Functions अनुमतियों का दुरुपयोग करके विशेषाधिकार बढ़ाना:
AWS - Step Functions PrivescLearn & practice AWS Hacking:HackTricks Training AWS Red Team Expert (ARTE) Learn & practice GCP Hacking: HackTricks Training GCP Red Team Expert (GRTE)
