Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Blog post of the powershell lab #1552

Open
wants to merge 13 commits into
base: main
Choose a base branch
from

Conversation

edunham
Copy link
Member

@edunham edunham commented Jan 11, 2025

This blog post has the following features:

  • A GitHub Repository with a polished README -- N/A
  • A GitHub Repository under the github.com/oktadev account -- N/A
  • A title that's approved by Dev Advocacy -- TBD, awaiting access to title analyzer
  • A URL approved by Dev Advocacy
  • The content has been run through Grammarly (https://www.grammarly.com/)
  • Rendered locally and confirmed that no Markdown typos exist
    • checking on the build to circumvent local npm breakage
  • Images are compressed appropriately -- it doesn't error...
  • Social image previews well on Twitter and LinkedIn
  • Tech review request (developer advocate or domain expert) -- done
  • Review request for editorial/grammar/clarity (developer advocate or Colton)

Copy link

netlify bot commented Jan 11, 2025

Deploy Preview for okta-blog ready!

Name Link
🔨 Latest commit 0c16bcf
🔍 Latest deploy log https://app.netlify.com/sites/okta-blog/deploys/6791cedfb7bbb500083373b8
😎 Deploy Preview https://deploy-preview-1552--okta-blog.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@edunham edunham requested a review from palermo4 January 23, 2025 05:07
@isemona isemona self-requested a review January 23, 2025 21:07
Copy link
Member

@alisaduncan alisaduncan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes requested

---
layout: blog_post
title: "Oktane Lab: Scaling Okta App Management by Importing Data from PowerShell into Terraform"
author: E. Dunham
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the author property, not written name. So it should be something like alisa-duncan and it links to my author profile.

Might want to double check locally

@@ -0,0 +1,362 @@
---
layout: blog_post
title: "Oktane Lab: Scaling Okta App Management by Importing Data from PowerShell into Terraform"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Out of curiousity, do you need "Oktane Lab" in there? According to the headline analyzer I use, it's much too long at 75 characters

Your headline is much too long. At this length, it will get cut off in search results. Try reducing it to about 55 characters.

It also scores a 31, which is pretty low (I shoot for closer to 70). Removing "Oktane Lab:" gets it in the correct wordcount and a score of 37.

type: awareness
---

At Oktane 2024, we offered a lab session to teach the basics of automating Okta administration tasks with Terraform and PowerShell. This blog post will walk you through the content taught in that lab so you can follow along at your own pace to get some hands-on experience managing an Okta tenant with both tools.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
At Oktane 2024, we offered a lab session to teach the basics of automating Okta administration tasks with Terraform and PowerShell. This blog post will walk you through the content taught in that lab so you can follow along at your own pace to get some hands-on experience managing an Okta tenant with both tools.
At Oktane 2024, we offered a lab session to teach the basics of automating Okta administration tasks with Terraform and PowerShell. This post walks you through the lab content so you can follow along at your own pace to get some hands-on experience managing an Okta tenant with both tools.

Active and I feel like we prefer "post" instead of "blog" or "blog post" based on my past review notes


When an identity administrator gives a person the ability to make changes in Okta, they provision the person with credentials to authenticate and scopes to indicate what they're authorized to do. When you set up an automation tool in your Okta organization, it's similar to onboarding any other colleague: Your tool will need credentials to authenticate and scopes to indicate what it's authorized to do.

## Scenario
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just my 2cents

This might be a candidate for calling out a section in a quote note.

> **Scenario**
>
> You are on the DevOps team at Okta Ice....


Terraform is a specialized tool for developing infrastructure as code. Terraform requires more setup steps than PowerShell, but adding Okta management to an existing Terraform deployment is more straightforward than designing a new solution with PowerShell.

## How to create your lab environment
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we state which versions of Terraform and Okta PowerShell to use (or state which versions you used when testing this lab)? We should pin versions as much as we can


Note that Terraform creates a `.tfstate` file. Each real-world resource should only be represented in one `.tfstate` file. If you're collaborating on a Terraform codebase, products like [Terraform Cloud](https://www.hashicorp.com/resources/what-is-terraform-cloud) are available to help you manage shared access to `.tfstate` files.

You will save a private key alongside your code to simplify the lab. In production, you should store keys in your organization's secrets management solution. Because private keys are secrets, follow your organization's best practices for secrets management when dealing with them.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You will save a private key alongside your code to simplify the lab. In production, you should store keys in your organization's secrets management solution. Because private keys are secrets, follow your organization's best practices for secrets management when dealing with them.
You'll save a private key alongside your code to simplify the lab. In production, you should store keys in your organization's secrets management solution. Because private keys are secrets, follow your organization's best practices for secrets management when dealing with them.

use contractions as listed in our style guide


To use Terraform, you'll run commands in a terminal. You can even use a PowerShell window if you don't have a favorite terminal!

If this is your first time writing code, you might want to install an IDE like [Visual Studio](https://code.visualstudio.com/docs/introvideos/basics) so that you can navigate the files you're writing, detect errors using plugins, and execute commands using the built-in terminal.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should IDE be defined for this audience?

```
terraform init
terraform plan
```
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think you're missing a newline or something. the syntax highlighting in GH is catching a problem here

8. Authenticate to your Okta Training Org when prompted.
9. In your PowerShell session, run the command `Invoke-OktaListApplications`

## Extra Credit
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

headers should be sentence case.


## Manage Terraform in Terraform

1) In your PowerShell session from the previous section, run the command `powershell Invoke-OktaListApplications`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why did this numbering system change to parens instead of a dot?

---
layout: blog_post
title: "Oktane Lab: Scaling Okta App Management by Importing Data from PowerShell into Terraform"
author: E. Dunham
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

edunham

- Install [PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell?view=powershell-7.4).
- Install the [official Okta PowerShell module](https://github.com/okta/okta-powershell-cli) from your preferred PowerShell module location.
- Install [Terraform](https://developer.hashicorp.com/terraform/tutorials/aws-get-started/install-cli).
- Create an Okta org by [signing up](/signup/) for Workforce Identity Cloud.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

link to okta org creation not working


When an identity administrator gives a person the ability to make changes in Okta, they provision the person with credentials to authenticate and scopes to indicate what they're authorized to do. When you set up an automation tool in your Okta organization, it's similar to onboarding any other colleague: Your tool will need credentials to authenticate and scopes to indicate what it's authorized to do.

## Scenario
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Enterprise scenario 1? For SEO on headers


If you aren't using PowerShell, you can get the Terraform integration ID from the Okta admin console instead.

## Scenario
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Enterprise scenario 2?

}
```

## Conclusion
Copy link
Contributor

@isemona isemona Jan 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Continue learning more about PowerShell and Terraform -- suggestion for SEO

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants