[Francesco Lana (Frank802)]

This pull request introduces several improvements to the Azure Agentic SDLC challenge documentation and scripts, focusing on clearer instructions for setting up the environment and adding automation for secure Azure authentication using OIDC and managed identities.

Key improvements include:

• Enhanced instructions for forking the repo and creating Codespaces to reduce setup errors.
• Clarified documentation on repository structure and Azure deployment.
• Added a comprehensive setup-oidc.sh script to automate Azure OIDC authentication setup with managed identities.
• Updated solution documentation to reference the new script and best practices.

---

Documentation and Setup Instructions:

• Updated the challenge instructions to specify the exact hackathon GitHub account and organization to use, including naming conventions for forks, and clarified the Codespaces setup process to prevent common mistakes.
• Improved the repo exploration step to clarify the role of infra/ and scripts/ directories in Azure setup and deployment.

Azure OIDC Authentication Automation:

• Added a new scripts/setup-oidc.sh Bash script that automates the creation of a user-assigned managed identity, assigns it the Contributor role, configures federated credentials for GitHub Actions, and pushes necessary secrets and variables to the GitHub repo. This streamlines and secures the Azure authentication setup for CI/CD workflows.

Solution Documentation:

• Updated the deployment walkthrough to recommend using OIDC federated credentials with a user-assigned managed identity and referenced the new setup-oidc.sh script to guide users toward secure, automated setup.