{"id":287,"date":"2024-01-29T16:44:23","date_gmt":"2024-01-30T00:44:23","guid":{"rendered":"https:\/\/www.dumpsterfirecomputing.com\/?p=287"},"modified":"2024-01-29T16:46:56","modified_gmt":"2024-01-30T00:46:56","slug":"creatortagger-a-whodunnit","status":"publish","type":"post","link":"https:\/\/www.dumpsterfirecomputing.com\/?p=287","title":{"rendered":"CreatorTagger – A Whodunnit"},"content":{"rendered":"\n

“Be careful which rocks you look under…”<\/em><\/p>\n\n\n\n

I had a thought the other day. Probably not a very good one, but it led to some tinkering. I wondered if it would be possible to leverage Azure Policy to add a tag to a resource denoting who built it. There are some limitations to both Activity Log and Log Analytics Workspace (for sending logs), and while the resource group deployment events are available, the “who did it” seems lacking.<\/p>\n\n\n\n

As it turns out, no. You can’t use Azure Policy yet to do this specific task. But Anthony Watherston wrote a unique solution to this leveraging an Event Grid Subscription, sending Write events to an Azure Function, which will tag the resource. See his full blog post titled “Tagging Azure Resources with a Creator<\/a>” – it’s quite good, and he has some code available for deploying the solution.<\/p>\n\n\n\n

What I wanted to do though was manually build the bits. I’ve supported other people’s Azure Functions, but haven’t deployed my own. I’ve looked at Event Grid, but never Subscriptions. So rather than take Anthony’s code and just deploy it, I poked at things to recreate it manually. This ultimately helped me understand all the parts and pieces, which then helped me understand his code more easily.<\/p>\n\n\n\n

Note: I’ve paired this blog post with a YouTube video<\/a> demonstrating the process.<\/em> It should be worth noting I’m still learning about video editing, so judge accordingly!<\/em><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Creating the Function App, we’re leveraging PowerShell Core as the runtime. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Function Apps want a storage account for storing function code and other configuration files. As with nearly everything Azure-related, Microsoft has a good set of documentation<\/a> around considerations for the storage account. I’ve opted to create a new storage account for this. Mostly because my lab doesn’t have any shared accounts, but also because I prefer the isolation. Microsoft even recommends<\/a> a single storage account for each function app in production for performance reasons (though I’m sure there are security benefits as well).<\/p>\n\n\n\n

The rest of the settings were kept as default and then deployed.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Once deployed, the first thing to do is enable a System assigned managed identity on the Function App. This managed identity will be the account under which tag actions take place.<\/p>\n\n\n\n

In order to actually do that work, it’s going to need permissions. I’ve scoped the permissions at the subscription level by creating two new role assignments for Read and Tag Contributor<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n
\"\"<\/figure>\n\n\n\n

With the permissions established, the next step is to actually create the function. I stumbled a few times with this, but on the Overview page of the function you can add it here<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The function will be triggered by an Event Grid action, and as you can see I just used the default name for the actual function itself.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

One of the things that tripped me up a little bit was the requirement for the Az module for PowerShell. It tripped me up because I didn’t quite understand where that import needed to take place until I poked around and found the requirements.psd1 file located in the App Files section. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The entire Az module is massive, and it’s good practice to import only what you need. From line 5 of the code they point you to https:\/\/www.powershellgallery.com\/packages\/Az<\/a>, where we can locate the latest major version of the two modules needed.<\/p>\n\n\n\n

The last thing to do with the Azure Function is to plop in the code to do the tagging work. I’m not going to replicate the code here, as the kudos need to go to Anthony<\/a> for coming up with a workable script (you can find all this code on his page). I simply copy\/paste the code into the function and made a single change. I preferred the output in the commented-out line 3 to the uncommented line 4.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

So, swapping those two lines, I saved the function.<\/p>\n\n\n\n

The last thing to do is set up the Event Grid Subscription which will send notifications to the Function App.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

In the screen above, the Topic describes where we’re going to get events from. For my example I want subscription-wide events. By default, there are 9 event types that can be collected. Remove all but “Resource Write Success”, which is all we care about. If someone successfully deploys a resource, that’s when it’ll need a tag.<\/p>\n\n\n\n

Finally, the endpoint type is the Azure Function, and when you click the “Configure an endpoint”, it’s simply a matter of targeting the Azure Function we built. And that’s…..all it took!<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Oh bugger.<\/p>\n\n\n\n

If you run into the above – don’t panic. Turns out, the Microsoft.EventGrid resource provider in my subscription was not enabled. If this happens to you, browse to your subscription, click the Resource Providers blade, and filter for the Event Grid. Here’s what mine looked like at the time of the above error:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Highlight the Microsoft.EventGrid, click Register above, and it takes about a minute or so to enable.<\/p>\n\n\n\n

Lastly, the test. I built a plain old Virtual Network<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The above view is immediately after creation – the Virtual Network has a costcenter tag, which it had inherited from the Resource Group. After another minute or so (probably less, actually), the new tag appeared with my name as the creator:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

I like this for a number of reasons. In Azure, tags are case-sensitive. So if you allow people to edit\/update tags manually, you’ll find “John Doe”, “john doe”, “doe, john”, or even “JohnDoe” all as separate unique tag values. This takes that inconsistency out of it (in fact, the tag name and value could be sent through a string ToLower() function just to force some consistency in formatting).<\/p>\n\n\n\n

This was a fun exercise and got me thinking a bit about Function Apps a little more – and a pretty inexpensive solutions as well!<\/p>\n","protected":false},"excerpt":{"rendered":"

“Be careful which rocks you look under…” I had a thought the other day. Probably not a very good one, but it led to some tinkering. I wondered if it […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-287","post","type-post","status-publish","format-standard","hentry","category-general"],"_links":{"self":[{"href":"https:\/\/www.dumpsterfirecomputing.com\/index.php?rest_route=\/wp\/v2\/posts\/287","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.dumpsterfirecomputing.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.dumpsterfirecomputing.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.dumpsterfirecomputing.com\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.dumpsterfirecomputing.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=287"}],"version-history":[{"count":6,"href":"https:\/\/www.dumpsterfirecomputing.com\/index.php?rest_route=\/wp\/v2\/posts\/287\/revisions"}],"predecessor-version":[{"id":311,"href":"https:\/\/www.dumpsterfirecomputing.com\/index.php?rest_route=\/wp\/v2\/posts\/287\/revisions\/311"}],"wp:attachment":[{"href":"https:\/\/www.dumpsterfirecomputing.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=287"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.dumpsterfirecomputing.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=287"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.dumpsterfirecomputing.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=287"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}