# macOS Permission Issues

## Allowing the grpc\_csharp\_ext.bundle dll file in macOS

Using external DLLs in Unity on MacOS can lead to security permission issues due to Apple's strict security measures. Here's a step-by-step guide to resolving this common problem.

1. **Verify the Problem**:

   <figure><img src="/files/OQOO9WK3JcGwVfLEplXD" alt=""><figcaption></figcaption></figure>

2. **Manually Allow Blocked DLLs**:

   * Open System Preferences on your Mac.
   * Navigate to "Security & Privacy".

   <img src="/files/MiZERlAXBXLVhkb7Ft8O" alt="" data-size="original">

   * Under the "Security" tab, you might see a message at the bottom about the DLL being blocked. Click "Allow Anyway" or "Open Anyway" and enter password if asked.

   ![](/files/NU2rztdy40O0BWN03srG)![](/files/Dn0Z1QZgOqxEELlqwRpG)

3. **Modify Gatekeeper settings**: MacOS's Gatekeeper can prevent unidentified developers' software from running. To allow the DLL:
   * Open the Terminal (found in Applications > Utilities).
   * Type `sudo spctl --master-disable` and press Enter.
   * This command will allow apps to be downloaded from anywhere.
   * Now, try running the Unity project again.
   * After you're done, you should re-enable Gatekeeper with `sudo spctl --master-enable`  to avoid any malware.

4. **Check File Permissions**: Ensure the DLL has the correct file permissions.
   * In Finder, right-click (or control-click) on the DLL file and choose "Get Info".
   * Under “Sharing & Permissions”, ensure that your user account has "Read & Write" permissions.

5. **Review Unity's Plugin Settings**:
   * In the Unity editor, select the DLL in the Project view.
   * In the Inspector window, make sure the appropriate platform (in this case, Mac OS X) and architecture (Apple Silicon, Intel-64) is selected for the DLL.
   * Ensure that the "Load on Startup" and other pertinent options are checked (should be enabled by default)

## Mac Configuration in Player Settings during build

* **Update Mac Configuration:**

  * In Unity, navigate to `Edit > Project Settings > Player`.
  * Scroll down and click on `Other Settings`

  <figure><img src="/files/6P3PTx54YPNCEkJcFjLI" alt=""><figcaption></figcaption></figure>

  * Scroll down again to find Mac Configuration section

  <figure><img src="/files/ZWDTSoP35Zuz88BnRFxo" alt=""><figcaption></figcaption></figure>

  * Update the Mac Configuration section (follow the below Screenshot)

  <figure><img src="/files/CzqZJJWCygQtO9w0luix" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.convai.com/api-docs/plugins-and-integrations/unity-plugin/troubleshooting-guide/macos-permission-issues.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
