Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion skills/using-unity/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ A skill may tell you to use, load or check for another skill by name, for exampl
- **import-and-optimize-cad-models**: Imports and optimizes CAD models and point clouds with Asset Transformer Toolkit (Pixyz). Make sure to use this skill when the user wants to import CAD or point cloud files, or build RuleSets, Actions, or LODs for them. File: `references/import-and-optimize-cad-models/import-and-optimize-cad-models.md`
- **initialize-ai-navigation**: Sets up and configures Unity AI Navigation, including NavMesh surfaces, agents, obstacles, and links. Use when the user asks about navigation meshes, pathfinding, patrol routes, or obstacle avoidance. File: `references/initialize-ai-navigation/initialize-ai-navigation.md`
- **instrument-game-telemetry**: Adds telemetry events to a Unity game with the Insights Events package, covering retention, level difficulty and economy balance. Use to instrument, add, extend, retrofit or fix game analytics, telemetry or tracking, or to migrate from Firebase, GA4 or AppsFlyer. Not for querying or exporting data already collected. File: `references/instrument-game-telemetry/instrument-game-telemetry.md`
- **levelplay-unity-integration**: Integrates the LevelPlay ad mediation SDK via the Ads Mediation package. Use when the user asks about adding rewarded, interstitial, or banner ads, mediation or ad privacy setup, Android or iOS ad dependency build failures, or migrating from Unity Ads or IronSource APIs. File: `references/levelplay-unity-integration/levelplay-unity-integration.md`
- **levelplay-unity-integration**: Integrates the LevelPlay ad mediation SDK (Ads Mediation package). Use for where ads belong in a game, rewarded, interstitial or banner ads, mediation or privacy setup, Android or iOS ad build failures, or migrating from Unity Ads or IronSource. File: `references/levelplay-unity-integration/levelplay-unity-integration.md`
- **localize-unity-project**: Sets up Unity Localization, including locales, String and Asset Tables, and CJK fonts. Use when the user wants to add languages or translate UI text. File: `references/localize-unity-project/localize-unity-project.md`
- **manage-sprite-atlas**: Manages SpriteAtlas assets through a prebuild pipeline, covering master and variant atlases, packing settings, and platform overrides. Use when asked to create or optimize sprite atlases. File: `references/manage-sprite-atlas/manage-sprite-atlas.md`
- **migrate-birp-to-urp**: Plans, executes, and troubleshoots migration from the Built-in Render Pipeline to URP. Use when asked to convert a project, scene, material, or shader to URP, or to fix visuals broken by the change. File: `references/migrate-birp-to-urp/migrate-birp-to-urp.md`
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Security notes: levelplay-unity-integration

When the user chooses it, this skill has the agent call the LevelPlay Management API to find or create the user's LevelPlay app and ad units (`references/management-api.md`). That means authenticated network calls with the user's account credentials, and resources created on the user's account. It is intentional, and it is limited by the safeguards below.

## Accepted risks

| Risk | Capability | Why it is accepted |
|---|---|---|
| Authenticated network calls | Sends HTTPS requests to `platform.ironsrc.com` with a secret key and refresh token read from the environment variables `LEVELPLAY_SECRET_KEY` and `LEVELPLAY_REFRESH_TOKEN` | The user sets the variables themselves and chooses this path over the dashboard. The calls go only to the LevelPlay platform host that issued the credentials, and only to the documented auth, applications and ad units endpoints. |
| Resources that cannot be deleted through the API | Creates apps and ad units on the user's LevelPlay account | The API has no delete call, so the agent lists what exists first, reuses it, and creates only what is missing, after the user confirms a table of exactly what will be created. |

## Mitigations

- **Credentials from the environment only.** The agent never asks the user to paste the secret key or refresh token, references them only as `$LEVELPLAY_SECRET_KEY` and `$LEVELPLAY_REFRESH_TOKEN` in commands, and checks them with `test -n` rather than printing them.
- **Never echoed, logged or written.** The credentials and the bearer token are never printed, never sent with verbose or tracing flags, and never written to a project file, an `.env` inside the project, a commit or generated C#.
- **Explicit confirmation before any create call.** The agent shows one table of every app and ad unit it will create, states that they cannot be deleted through the API, and proceeds only on an explicit yes.
- **Reuse before create.** Existing apps are matched by name and platform, and existing ad units by format, so a repeated run creates nothing new.
- **Project names never enter a shell command.** The app and ad unit names come from the project's files. The agent writes each create call's JSON body to a temporary file outside the project with its file-writing tool, checks it with `python3 -m json.tool`, sends it with `curl --data-binary @file`, and deletes the file, so a quote or other shell character in a name cannot end the command early or run anything.
- **Documented endpoints only.** The agent calls only the auth, applications and ad units endpoints described in the LevelPlay API documentation. It does not enable networks, change billing or take an app live.
- **No third-party hosts.** No request goes anywhere but `platform.ironsrc.com`, and no response is executed.
Loading
Loading