After my recent blog post, my old mate @_Dark_Knight_ reached out to me and he asked me a question:

1. Macos Dyld_fallback_library_path
2. Mac Dyld Library Not Loaded
3. Mac Dyld Shared Cache

For quick testing and debugging in a development environment, it's a hassle to have to make temporary copies of libraries, hack in @rpath changes, and then possibly forget about the manual change. DYLDFALLBACKLIBRARYPATH and DYLDLIBRARYPATH were handy for these occasional dev/test cycles. – Guy Mar 1 '17 at 14:16. The DYLDFALLBACKLIBRARYPATH environment variable; differences in how RStudio launches R versus launching R at the command line. Either as a DLL on Windows or as a shared object on Mac and Linux.' This is intriguing, because it suggests that there may be. Oct 13, 2016  I think the issue is not connected with cmake configuration. I think the issue is connected with macOS Sierra SIP feature. Where should be a way how to break through SIP and allow to load dynamic libraries not from system defined paths. Jul 01, 2013  Hey folks, I am having a bit of a baffling problem. My app out of xamarin.mac works fine so long as I double click it or run it from terminal. Failing on libc.dylib. When launching an app appears to set its own DYLDFALLBACKLIBRARYPATH without storing what is already there. This is so they can bundle their own dylibs as fallbacks.

“Do you typically callout user apps that allow dyld_insert_libraries?”

In shell scripts used for unit testing with dynamic libraries in a directory other than the typical @rpath, I have previously been able to set DYLDFALLBACKLIBRARYPATH to set the directory contai. 15 How do I switch between the Mac/X11 drivers? As of 1.5.28, the Mac driver is the default driver. If on an older release, you can force using the Mac driver by either: $ unset DISPLAY Or by editing the registry key 'graphics' under HKCUSoftwareWineDrivers. It should specify the load order, e.g., 'mac,x11'.

And a few similar ones, and I will be honest, I had no idea what is he talking about, if only I understood the question :D Despite the fact that my recent blog posts and talks are about macOS, I deal much more with Windows on a daily basis, probably like 95%, and macOS is still a whole new territory for me. So I decided to dig into the question and learn a bit more about this.

As it turns out there is a very well known injection technique for macOS utilizing DYLD_INSERT_LIBRARIES environment variable. Here is the description of the variable from the dyld man document:

Stack Exchange network consists of 175 Q&A communities including Stack Overflow, the largest, most trusted online community for developers to learn, share.

In short, it will load any dylibs you specify in this variable before the program loads, essentially injecting a dylib into the application. Let’s try it! I took my previous dylib code I used when playing with dylib hijacking:

Compile:

For a quick test I made a sophisticated hello world C code, and tried it with that. In order to set the environment variable for the application to be executed, you need to specify DYLD_INSERT_LIBRARIES=[path to your dylib] in the command line. Here is how it looks like:

Executing my favourite note taker application, Bear (where I’m writing this right now) is also affected:

We can also see all these events in the log (as our dylib puts there a message):

There are two nice examples in the following blog posts about how to hook the application itself:

I will not repeat those, so if you are interested please read those.

Macos Dyld_fallback_library_path

Can you prevent this infection? Michael mentioned that you can do it by adding a RESTRICTED segment at compile time, so I decided to research it more. According to Blocking Code Injection on iOS and OS X there are three cases when this environment variable will be ignored:

1. setuid and/or setgid bits are set
2. restricted by entitlements
3. restricted segment

We can actually see this in the source code of dyld - this is an older version, but it’s also more readable: https://opensource.apple.com/source/dyld/dyld-210.2.3/src/dyld.cpp

The function pruneEnvironmentVariables will remove the environment variables:

If we search where the variable sRestrictedReason is set, we arrive to the function processRestricted:

This is the code segment that will identify the restricted segment:

Now, the above is the old source code, that was referred in the article above - since then it has evolved. The latest available code is dyld.cpp looks slightly more complicated, but essentially the same idea. Here is the relevant code segment, that sets the restriction, and the one that returns it (configureProcessRestrictions , processIsRestricted):

It will set the gLinkContext.allowEnvVarsPath to false if:

1. The main executable has restricted segment
2. suid / guid bits are set
3. SIP is enabled (if anyone wonders CSR_ALLOW_TASK_FOR_PID is a SIP boot configuration flag, but I don’t know much more about it) and the program has the CS_RESTRICT flag (on OSX = program was signed with entitlements)

But! It’s unset if CS_REQUIRE_LV is set. What this flag does? If it’s set for the main binary, it means that the loader will verify every single dylib loaded into the application, if they were signed with the same key as the main executable. If we think about this it kinda makes sense, as you can only inject a dylib to the application that was developed by the same person. You can only abuse this if you have access to that code signing certificate - or not, more on that later ;).

There is another option to protect the application, and it’s enabling Hardened Runtime. Then if you want, you can specifically enable DYLD environment variables: Allow DYLD Environment Variables Entitlement - Entitlements. The above source code seems to be dated back to 2013, and this option is only available since Mojave (10.14), which was released last year (2018), probably this is why we don’t see anything about this in the source code.

For the record, these are the values of the CS flags, taken from cs_blobs.h

This was the theory, let’s see all of these in practice, if they indeed work as advertised. I will create an Xcode project and modify the configuration as needed. Before that we can use our original code for the SUID bit testing, and as we can see it works as expected:

Interestingly, in the past, there was an LPE bug from incorrectly handling one of the environment variables, and with SUID files, you could achieve privilege escalation, here you can read the details:OS X 10.10 DYLD_PRINT_TO_FILE Local Privilege Escalation Vulnerability SektionEins GmbH

I created a complete blank Cocoa App for testing the other stuff. I also export the environment variable, so we don’t need to specify it always:

If we compile it, and run as default, we can see that dylib is injected:

To have a restricted section, on the Build Settings -> Linking -> Other linker flags let’s set this value:

If we recompile, we will see a whole bunch of errors, that dylibs are being ignored, like these:

Our dylib is also not loaded, so indeed it works as expected. We can verify the segment being present with the size command, and indeed we can see it there:

Alternatively we can use the otool -l [path to the binary] command for the same purpose, the output will be slightly different.

Next one is setting the app to have ( hardened runtime ), we can do this at the Build Settings -> Signing -> Enable Hardened Runtime or at the Capabilities section. If we do this and rebuild the app, and try to run it, we get the following error:

If I code sign my dylib using the same certificate the dylib will be loaded:

If I use another certificate for code signing, it won’t be loaded as you can see below. I want to highlight that this verification is always being done, it’s not a Gatekeeper thing.

Interestingly, even if I set the com.apple.security.cs.allow-dyld-environment-variables entitlement at the capabilities page, I can’t load a dylib with other signature. Not sure what I’m doing wrong.

To move on, let’s set the library validation (CS_REQUIRE_LV) requirement for the application. It can be done, by going to Build Settings -> Signing -> Other Code Signing Flags and set it to -o library. If we recompile and check the code signature for our binary, we can see it enabled:

And we get the same error message as with the hardened runtime if we try to load a dylib with different signer.

The last item to try would be to set the CS_RESTRICT flag, but the only thing I found about this is that it’s a special flag only set for Apple binaries. If anyone can give more background, let me know, I’m curious. The only thing I could do to verify it, is trying to inject to an Apple binary, which doesn’t have the previous flags set, not a suid file neither has a RESTRICTED segment. Interestingly the CS_RESTRICT flag is not reflected by the code signing utility. I picked up Disk Utility. Indeed our dylib is not loaded:

I would say that’s all, but no. Let’s go back to the fact that you can inject a dylib even to SUID files if the CS_REQUIRE_LV flag is set. (In fact probably also to files with the CS_RUNTIME flag). Yes, only dylibs with the same signature, but there is a potential (although small) for privilege escalation. To show, I modified my dylib:

Let’s sign this, and the test program with the same certificate and set the SUID bit for the test binary and run it. As we can see we can inject a dylib as expected and indeed it will run as root.

Mac Dyld Library Not Loaded

In theory you need one of the following to exploit this:

1. Have the code signing certificate of the original executable (very unlikely)
2. Have write access to the folder, where the file with SUID bit present -> in this case you can sign the file with your own certificate (code sign will replace the file you sign, so it will delete the original and create a new - this is possible because on *nix systems you can delete files from directories, where you are the owner even if the file is owned by root), wait for the SUID bit to be restored (fingers crossed) and finally inject your own dylib. You would think that such scenario wouldn’t exist, but I did find an example for it.

Getting rid of idrive from mac library. Here is a quick and dirty python script to find #2 items, mostly put together from StackOverflow :D

One last thought on this topic is GateKeeper. You can inject quarantine flagged binaries in Mojave, which in fact is pretty much expected.

However it doesn’t work anymore on Catalina, which is also expected with the introduced changes:

Jan 12, 2020  OS X hides the Library folder, which is used often in Mac troubleshooting. Here's how to get it back. The user's Library has long been a go-to location for troubleshooting issues with individual applications or components shared by multiple applications. Jul 22, 2011  Hold Option and Use the “Go” Menu to Show Library. Holding down the Option key will show the “Library” directory as an option in the Finders Go menu. The other nice thing about the Go menu is that after you have accessed /Library on multiple occasions, it will start to appear in the “Recent Folders” submenu for easy repeat access. Access Hidden Library Menu Option On Mac. Follow the steps below to access the Hidden Library Menu option on your Mac. Left-click your mouse anywhere on the screen of your Mac. This will reveal the Go Option in the top menu bar of your Mac. You can also click on the Finder Icon in the Dock of your Mac to activate the Go Option. Option go library macon ga. Dec 12, 2016  How to Access User Library in MacOS Mojave, macOS Catalina, and MacOS Sierra. If you don’t need to constantly show the /Library folder on the Mac, you can just access it when needed by using the “Go” menu: From the Finder of Mac OS, pull down the “Go” menu and hold down the SHIFT key; Choose “Library” from the drop down list.

We got a very similar error message as before:

Mac Dyld Shared Cache

I think applications should protect themselves against this type of dylib injection, and as it stands, it’s pretty easy to do, you have a handful of options, so there is really no reason not to do so. As Apple is moving towards notarization hardened runtime will be enabled slowly for most/all applications (it is mandatory for notarised apps), so hopefully this injection technique will fade away slowly. If you develop an app where you set the SUID bit, be sure to properly set permissions for the parent folder.

GIST link to codes:DYLD_INSERT_LIBRARIES DYLIB injection in macOS / OSX deep dive · GitHub