Skip to content

osy 0.19.6

Choose a tag to compare

@osysharp-publisher osysharp-publisher released this 12 Nov 11:24

This release makes the rules on outbound hosts hold however a host's name is spelled, stops an ordering from revealing a value you may not read, and lets an organisation keep its outbound hosts as a versioned policy. One thing that passed before is now refused: an allow written exactly *.. To upgrade, run osy upgrade, then osy update in a project.

Breaking changes

  • A blocked outbound host is blocked under every spelling of its name. Host rules are now compared by the name a host resolves as: case, a trailing dot (also the ideographic and full-width dots 。 . 。), the Unicode and xn-- forms of one name, and compatibility characters (full-width letters, ſ for s). A call to a blocked host written one of those ways used to pass the block; it is refused now, from your app's code, from a kit and in Http.Refusal. A block that was itself written with a trailing dot or in Unicode now applies to the name written plainly. Nothing to change in an app: a name written plainly against a rule written plainly is decided exactly as before.
  • An allow written exactly *. matches nothing. An asterisk, a dot and nothing after used to allow every host called with a trailing dot. It now allows none. This is the one case where a call that no block was meant to stop is newly refused. Fix: write the hosts you mean, such as *.example.com.
  • A rate limit on a host counts every spelling. A call to a rate-limited host written with a trailing dot or as its Unicode or xn-- twin counts against the rule's limit.
  • A rule with an asterisk that is not the plain * is refused when it is set. *.example.com (full-width or small asterisk) in a deploy's rules is refused; one already stored is compared as the wildcard.
  • Ordering by a member you may not read no longer reveals its order. $orderby in REST, the MCP query tools and the context endpoint used to place a row by a value that a deny read hides from the caller. Rows whose value is hidden from the caller now stand together, in id order. An order on a field no rule hides is unchanged. Docs

Fixes

  • A host you allowed is allowed under every spelling. A host on an allow list (your app's or your organisation's), a package's granted host and the declared host of a secret are matched by the name they resolve to, in any of the spellings above. Blocks and the organisation's list still decide after.
  • GET /api/egress says when an organisation's policy decides. It names the policy version the organisation's rules came from, and says when every outbound call is refused because that version's hosts cannot be read.

Organisation policy (REST only, no page yet)

  • An organisation can keep a policy in versions. Its Owner and Admin save a draft, approve it and revert to an earlier version through the REST API of Admin, and anyone in the organisation can read the version in force. The routes, all POST: /organizations/policy/draft, /organizations/policy/approve, /organizations/policy/revert, /organizations/policy/in-force, /organizations/policy/approvals-needed and /organizations/policy/machines-may-approve. A platform operator can read a policy and cannot save or approve one.
  • Approvals. An organisation sets how many approvals a version needs; only an Owner lowers the number, and only an Owner decides whether a machine account may approve.
  • Outbound hosts from the policy. A version's egress.hosts rule is the organisation's list of outbound hosts for its apps once that version is in force. An entry that is a pasted address is refused at the save, with the host to write instead. An organisation with no policy version, or a version without that rule, keeps its allowed and blocked hosts in Admin as before.

Kits

  • MarkdownEditor 1.2.1. A pending save goes out when the editor is closed, so text typed just before a drawer closes or a link is followed is no longer lost, and "dirty" is raised on every change of state.