launchpad development|
Size: 6354
Comment:
|
← Revision 19 as of 2019-08-22 11:39:20 ⇥
Size: 12901
Comment: webops → IS
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| = Private Projects and Distributions = Projects and distributions can be made private and all subordinate artefacts are also private. Owners can grant users and team permission to view all the the project and its contents. Owner can grant users a teams permission to view a branch or bug. '''As a ''' project owner<<BR>> '''I want ''' hide my project from all users except those I allow<<BR>> '''so that ''' development activity are not disclosed to competitors<<BR>> This feature is about managing the disclosure of information to ensure companies can develop software without revealing their intentions to rivals. Trusted users and teams, such a company employees have unrestricted access to view all aspects of the project. Clients or developers can be permitted to view specific bugs or branches, revealing only the names of the connected artefacts. This is a part of the [[LEP/BetterPrivacy]]. |
## page was renamed from LEP/PrivateProjectsAndDistributions = Private Projects = Private projects are useful primarily in two scenarios: * a Canonical team is working on a project that is not yet public * a non-Canonical group or individual wants to host a proprietary and private project on Launchpad. Privacy means that the project can be made private, along with all of its subordinate artefacts. Thanks to the Manage Sharing work, the project's maintainers can share aspects of the project with selected individuals and teams. In addition, trusted individuals and teams can be given access to see everything. This is a part of the [[LEP/BetterPrivacy|Better Privacy]] project. |
| Line 26: | Line 20: |
| and between its partners in cases where they rival each other. Private projects and distros allow Canonical to control who it shares information with in Launchpad. |
and between its partners in cases where they rival each other. Even seemingly harmless data can give away valuable insight into a commercial relationship, schedule or other proprietary information. Similarly, we have a number of commercial subscribers who are willing to pay to have this functionality for their non-Canonical projects. We want to ensure that Canonical, its partners and our Launchpad commercial subscribers can use Launchpad confident in the knowledge that their project, all its subordinate artefacts and pages are hidden from everyone except for trusted users. |
| Line 34: | Line 31: |
| * OEM (Joey Stanford, Steve Magoun, Cody A.W. Somerville) * Hardware enablement (Chris Van Hoof, Hugh Blemings) |
* PES, incl. Hardware Enablement (David Murphy) |
| Line 37: | Line 33: |
| * Landscape (Jamu Kakar) * UbuntuOne (Matt Griffin) |
* Product Strategy (Ted Gould) * Curtis Hovey (Launchpad Purple squad lead and leader of Launchpad's Better Privacy effort) Others within and outwise Canonical have useful things to say about this project and will have an input but we will judge our success, primarily, by the satisfaction of these named stakeholders. == Personas == * '''Chris:''' hardware enablement engineer working in PES * '''Hamish:''' a project manager in PES. More to come. == User stories == <<Anchor(stories)>> '''As a''' project manager (Hamish) in Canonical's PES team<<BR>> '''I want to''' hide all traces of my project from everyone other than those I specifically select<<BR>> '''so that''' I can protect the commercial confidentiality of our own activity as well as that of our clients and partners. '''As''' Hamish<<BR>> '''I want to''' have fine-grained control over the information trusted parties can see about my project<<BR>> '''so that''' Launchpad doesn't reveal any detail other than those I specifically allow for. '''As''' Hamish<<BR>> '''I want to''' be able to declare a project private at the point of registration<<BR>> '''so that''' there is no risk of exposing the project's existence. '''As''' Hamish<<BR>> '''I want to''' take an existing public project private<<BR>> '''so that''' I can take advantage of project privacy for those projects that were created before it was available and<<BR>> '''so that''' I can correct mistakes where a project was accidentally registered as public. '''As an''' engineering manager in Product Strategy<<BR>> '''I want to''' make an existing private project public, while retaining the privacy status of existing artefacts<<BR>> '''so that''' I can respect a project's publicity emgbargo but then make it open source with little effort, without breaking the confidentiality of conversations that were conducted under an assumption of privacy. '''As an''' engineering manager in Product Strategy<<BR>> '''I want to''' have daily builds from a private branch into a private PPA<<BR>> '''so that''' I and those I trust have an easy way to test the code we're writing. '''As an''' engineering manager in Product Strategy<<BR>> '''I want to''' work in private on an otherwise public project and then make that work public<<BR>> '''so that''' I can add a feature to an open source project without breaking an embargo. '''As an''' engineering manager in ISD<<BR>> '''I want to''' maintain a public project that has private bugs and/or branches<<BR>> '''so that''' community users can still file bugs on the correct project but without exposing proprietary information. |
| Line 43: | Line 85: |
| Line 46: | Line 87: |
| 1. A way of running projects in total privacy. <<BR>> Non-privileged users cannot know the project's name or see anything that belongs to the project. 1. A way of managing who can view a private project/distribution.<<BR>> Owners can grant users and teams permission to access and view all parts of the project. [[LEP/ManagingDisclosure]] 1. Owners can see all the user that have full access to the project. 1. Owners can revoke access for a user or a team. 1. This applies to '''private and public projects''' 1. A way to granting users and teams access to bugs and branches. <<BR>> Owners can grant users and teams access to a bug or branch and trust that the users can only learn the names of the things connected to it. 1. Always remind users that the information is confidential. <<BR>> When viewing the page of something that is private (either because it is private or the project/distro that is belongs to), the user can always '''see''' and '''know''' that they are responsible for not revealing the information to Non-privileged users. 1. Does not let users easily disclose project information <<BR>> Launchpad must guard how private artefacts are linked to public artefacts. 1. It must not be possible to grant permission or assign to a public team. 1. Launchpad must explain that assigning something like a blueprint to a non-privileged user will disclose information. Maybe assigning is not possible until permission is granted. 1. Artefacts like blueprints, bugs, and questions cannot be retargeted to another project. 1. Bugs cannot be shared (ie, multiple BugTagets) because that can disclose information in comments. [[LEP/BugLinking]] |
1. A way of running projects in total privacy.<<BR>> Untrusted users cannot know the project's name or see anything that belongs to the project. The project is not visible, it does not exist. 1. A way to make a project private during the registration process. 1. Sharing the project with a person (via a trust policy) makes the bare minimum information about the project visible to the person. 1. Sharing a bug or branch with a person makes the project's identifying information visible so that the user can traverse to the artefact. 1. Change a private project to a visible project. <<BR>> The maintainer may choose to make the project public after doing the initial development in secret. Artefacts where conversations have been conducted in private will remain proprietary by default. The maintainer can choose to make some of those artefacts public. === Nice to have === 1. Retain the existing "public project, private bugs/branches" hybrid model we have today. 1. A way to share the translations coming from private projects without exposing that project's name or other clues to its existence. 1. A way to share a project during setup so that maintainers do not miss vital steps to ensure ''all'' Canonical staff and the project contributors can do their job. 1. Daily builds from private branch into a private PPA. === Must not === 1. An untrusted user cannot see the project in listings. 1. An untrusted user cannot search for the project. 1. An untrusted user cannot URL hack to find the project. 1. A partially trusted user should not see anything other than precisely what they need in order to make sense of the artefact that is shared with them. 1. An untrusted user cannot guess the name of a private project based on the error message given when trying to register a new project with the same name. 1. An untrusted user cannot see the project when it is in a relationship with a bug ([[LEP/BugLinking]]), person related software, karma activity, translated messages. 1. Privacy must not add a significant performance penalty. 1. Privacy must not require detailed howtos to configure projects. Instead, it should be obvious from the UI. 1. Privacy must not require elaborate team hierarchies to manage access. 1. Privacy must not prevent company employees from seeing company information. |
| Line 81: | Line 141: |
| manage private projects and distros. Ideally, their current responsibilities | manage private projects. Ideally, their current responsibilities |
| Line 84: | Line 144: |
=== Nice to have === 1. Entitled users can create their own private projects and distros. <<BR>> Commercial admins can create and manage private contexts/artefacts now. Canonical stakeholders could do this themselves to ensure projects are procured quickly and minimize the involvement of commercial admins. 1. An intern can understand how to manage a private project. <<BR>> A good design will convey the what is private, how mange disclosure, and inform about the consequences of a change so that little experience is needed to use privacy. === Must not === 1. Privacy doesn't matter for almost everything, it must not clutter up the page for public things. 1. Privacy must not add a significant performance penalty. 1. Privacy must not require recipes to configure projects and distros. 1. Privacy must not require elaborate team hierarchies to manage access. 1. Privacy must not prevent company employees from seeing company information. 1. Must not require a DB query to circumvent a black listed name. |
=== Won't happen === These are things that are technically possible but that we have decided will not happen due to the cost of implementing them. We believe that the implementation cost outweighs the benefits. 1. Retargeting private bugs or blueprints. 1. Linking CVEs to proprietary bugs. 1. Multi-tenancy on private bugs. 1. Bug watches in private projects. 1. Bug and blueprint links to branches where any one is private. 1. Announcements and feeds for private projects. 1. Series retargeting. 1. Daily builds for private branches into P3As. 1. Answers for private projects: we will turn these off entirely. 1. Translations for private projects: we will turn these off entirely. |
| Line 116: | Line 170: |
Related projects that Purple have been working on: 1. [[LEP/TrustedPickers]] 1. [[LEP/PrivacyTransitions]] 1. [[LEP/HardenedBugsProjectsTeams]] 1. [[LEP/Entitlement]] |
|
| Line 120: | Line 184: |
| 1. [[LEP/BugLinking]] Cloning and linking a private project bug to another project. |
1. [[LEP/BugLinking]] |
| Line 126: | Line 189: |
| 1. Entitling a user to create private projects and distros. 1. Registering a private project or distro. 1. Granting full access to a user or team. 1. Granting partial access to a user or team via a bug or branch. 1. Viewing who has access, knowing its kind, and seeing a summary of what is disclosed. 1. Cloning and linking a private project bug to another project. |
1. The maintainer set the project visibility to private during project registration. 1. The maintainer makes an existing public project private. 1. The maintainer makes an existing private project public. 1. Sharing with a team and assigning roles during project registration. 1. When taking a private project public, the maintainer makes individual existing private artefacts public. 1. A trusted user attempts to view information that is not shared with them. 1. A trusted user attempts something that is not possible on a private project. |
| Line 144: | Line 208: |
| 1. An entitled user can register a private project or distribution. 1. The owner can grant access to to his company team so that everyone can view the entire project, including private bugs and code on public projects. 1. An owner/driver can subscribe a user to a branch or bug to grant access only to that item. 1. An owner can view the list of granted users, and in a single action, revoke access. 1. A non-privileged user cannot see the name or know the URL of a private project or distribution. 1. A non-privileged user cannot see private project artefacts like bugs, branches, blueprints, questions, milestones, and series when searching |
1. A Canonical staff member, or commercial subscriber, can register a new private project or take an existing public project private with no involvement from IS or members of the Launchpad team. 1. An untrusted user cannot see the name or know the URL of a private project. 1. An untrusted user cannot see private project artefacts like bugs, branches, blueprints, questions, milestones, and series when searching |
| Line 163: | Line 215: |
| 1. An untrusted user cannot deduce the name of a private project looking at the karma and software pages of the organisation's users or by other means, such as attempting to register a project with the same name. 1. A project maintainer can take a private project public with relatively little effort and choose which individual private artefacts to expose. |
|
| Line 169: | Line 225: |
| 1. All OEM and HWE owned projects are private <<BR>> We may want to restrict this to new projects or to active projects. |
1. The number of support queries the Launchpad team receives relating to privacy should reduce dramatically. It should be supremely easy to register and maintain a private project. 1. Our stakeholders confirm that their teams have all the private projects the need. 1. Interviews with stakeholders and individuals making use of this feature. |
| Line 174: | Line 233: |
* ISD want hybrid projects when the project is public but bugs and branches are private by default. Curtis seems to have ruled this out. Is this possible within our budget? * Once a private project is made public it's not just the bugs and branches that need to stay private. At the least we also need to consider Answers and Blueprints. What else? * How can we tell people that their bug comment, for example, is private and then later allow the project maintainer to expose it to the world? Isn't that rather obnoxious? * Is it simpler to disable karma for private projects rather than deal with the potential for leaks? ''The text below is quite old and may no longer relate to this LEP in its current form.''' This might be like private teams where they are completely invisible except to members. Private teams can be put in a public relationship that reveals it's identifying information, or placed in a trusted relationship that also reveals its members. Private projects might have a public relationship with project groups, but the consequences are scary. Canonical uses project groups to represent organisations, which have a trusted relationship. This feature is not about project groups or organisations, so private projects should not appear in listing or searches to untrusted users. There was a recent discussion where it was not obvious to developers how a user is trusted to see the project. Developers built a policy mechanism that support 3 kinds of trust, but stakeholders only asked for a mechanism to support proprietary development. Either any user in any trusted policy can see all the projects pages, or users just in the proprietary policy can see the project. We also know that proprietary projects do not use embargoed security and user data classifications because their workflows conflict with the need for secrecy. A proprietary project could use all three kinds of trust, but it is using them only within the context of the project. Supporting any trusted policy will reduce setup time for projects that choose to be different from Canonical. In the real world, a project is owned by an organisation that has delegated a maintainer. The organisation ''pays'' to ''own'' proprietary data. All data in the project is owned by an organisation. Concerns were brought up when discussing auditing that project maintainers might learn the members of a private team that has access to project data, but the maintainer is ''not'' a member of the team! This appears to be like the case where private teams are permitted to know all the members of private teams that are sub teams because a team has preeminent right to know who its members are -- a paying organisation has preeminent right to know who has access to its proprietary data. |
Private Projects
Private projects are useful primarily in two scenarios:
- a Canonical team is working on a project that is not yet public
- a non-Canonical group or individual wants to host a proprietary and private project on Launchpad.
Privacy means that the project can be made private, along with all of its subordinate artefacts.
Thanks to the Manage Sharing work, the project's maintainers can share aspects of the project with selected individuals and teams. In addition, trusted individuals and teams can be given access to see everything.
This is a part of the Better Privacy project.
Rationale
Canonical is developing a greater number of projects with a greater number of partners. Canonical needs to prevent disclosing its plans to its rivals, and between its partners in cases where they rival each other.
Even seemingly harmless data can give away valuable insight into a commercial relationship, schedule or other proprietary information.
Similarly, we have a number of commercial subscribers who are willing to pay to have this functionality for their non-Canonical projects.
We want to ensure that Canonical, its partners and our Launchpad commercial subscribers can use Launchpad confident in the knowledge that their project, all its subordinate artefacts and pages are hidden from everyone except for trusted users.
Stakeholders
- PES, incl. Hardware Enablement (David Murphy)
- ISD (Stuart Metcalfe)
- Product Strategy (Ted Gould)
- Curtis Hovey (Launchpad Purple squad lead and leader of Launchpad's Better Privacy effort)
Others within and outwise Canonical have useful things to say about this project and will have an input but we will judge our success, primarily, by the satisfaction of these named stakeholders.
Personas
Chris: hardware enablement engineer working in PES
Hamish: a project manager in PES.
More to come.
User stories
As a project manager (Hamish) in Canonical's PES team
I want to hide all traces of my project from everyone other than those I specifically select
so that I can protect the commercial confidentiality of our own activity as well as that of our clients and partners.
As Hamish
I want to have fine-grained control over the information trusted parties can see about my project
so that Launchpad doesn't reveal any detail other than those I specifically allow for.
As Hamish
I want to be able to declare a project private at the point of registration
so that there is no risk of exposing the project's existence.
As Hamish
I want to take an existing public project private
so that I can take advantage of project privacy for those projects that were created before it was available and
so that I can correct mistakes where a project was accidentally registered as public.
As an engineering manager in Product Strategy
I want to make an existing private project public, while retaining the privacy status of existing artefacts
so that I can respect a project's publicity emgbargo but then make it open source with little effort, without breaking the confidentiality of conversations that were conducted under an assumption of privacy.
As an engineering manager in Product Strategy
I want to have daily builds from a private branch into a private PPA
so that I and those I trust have an easy way to test the code we're writing.
As an engineering manager in Product Strategy
I want to work in private on an otherwise public project and then make that work public
so that I can add a feature to an open source project without breaking an embargo.
As an engineering manager in ISD
I want to maintain a public project that has private bugs and/or branches
so that community users can still file bugs on the correct project but without exposing proprietary information.
Constraints and Requirements
Must
A way of running projects in total privacy.
Untrusted users cannot know the project's name or see anything that belongs to the project. The project is not visible, it does not exist.- A way to make a project private during the registration process.
- Sharing the project with a person (via a trust policy) makes the bare minimum information about the project visible to the person.
- Sharing a bug or branch with a person makes the project's identifying information visible so that the user can traverse to the artefact.
Change a private project to a visible project.
The maintainer may choose to make the project public after doing the initial development in secret. Artefacts where conversations have been conducted in private will remain proprietary by default. The maintainer can choose to make some of those artefacts public.
Nice to have
- Retain the existing "public project, private bugs/branches" hybrid model we have today.
- A way to share the translations coming from private projects without exposing that project's name or other clues to its existence.
- A way to share a project during setup so that maintainers do not miss
vital steps to ensure all Canonical staff and the project contributors can do their job.
- Daily builds from private branch into a private PPA.
Must not
- An untrusted user cannot see the project in listings.
- An untrusted user cannot search for the project.
- An untrusted user cannot URL hack to find the project.
- A partially trusted user should not see anything other than precisely what they need in order to make sense of the artefact that is shared with them.
- An untrusted user cannot guess the name of a private project based on the error message given when trying to register a new project with the same name.
- An untrusted user cannot see the project when it is in a
relationship with a bug (LEP/BugLinking), person related software, karma activity, translated messages.
- Privacy must not add a significant performance penalty.
- Privacy must not require detailed howtos to configure projects. Instead, it should be obvious from the UI.
- Privacy must not require elaborate team hierarchies to manage access.
- Privacy must not prevent company employees from seeing company information.
Does not increase LOSAs and commercial admins involvement.
LOSAs and commercial admins should not take on new responsibilities to manage private projects. Ideally, their current responsibilities or involvement will decrease.
Won't happen
These are things that are technically possible but that we have decided will not happen due to the cost of implementing them. We believe that the implementation cost outweighs the benefits.
- Retargeting private bugs or blueprints.
- Linking CVEs to proprietary bugs.
- Multi-tenancy on private bugs.
- Bug watches in private projects.
- Bug and blueprint links to branches where any one is private.
- Announcements and feeds for private projects.
- Series retargeting.
Daily builds for private branches into P3As.
- Answers for private projects: we will turn these off entirely.
- Translations for private projects: we will turn these off entirely.
Subfeatures
Related projects that Purple have been working on:
LEP/ManagingDisclosure Viewing who has access, knowing its kind, and seeing a summary of what is disclosed.
Workflows
- The maintainer set the project visibility to private during project registration.
- The maintainer makes an existing public project private.
- The maintainer makes an existing private project public.
- Sharing with a team and assigning roles during project registration.
- When taking a private project public, the maintainer makes individual existing private artefacts public.
- A trusted user attempts to view information that is not shared with them.
- A trusted user attempts something that is not possible on a private project.
Success
How will we know when we are done?
- A Canonical staff member, or commercial subscriber, can register a new private project or take an existing public project private with no involvement from IS or members of the Launchpad team.
- An untrusted user cannot see the name or know the URL of a private project.
- An untrusted user cannot see private project artefacts like bugs, branches, blueprints, questions, milestones, and series when searching or listing collections.
- An untrusted user cannot deduce the name of a private project looking at the karma and software pages of the organisation's users or by other means, such as attempting to register a project with the same name.
- A project maintainer can take a private project public with relatively little effort and choose which individual private artefacts to expose.
How will we measure how well we have done?
The canonical team is granted access to all Canonical projects.
This will be knowable via a DB query.- The number of support queries the Launchpad team receives relating to privacy should reduce dramatically. It should be supremely easy to register and maintain a private project.
- Our stakeholders confirm that their teams have all the private projects the need.
- Interviews with stakeholders and individuals making use of this feature.
Thoughts?
- ISD want hybrid projects when the project is public but bugs and branches are private by default. Curtis seems to have ruled this out. Is this possible within our budget?
- Once a private project is made public it's not just the bugs and branches that need to stay private. At the least we also need to consider Answers and Blueprints. What else?
- How can we tell people that their bug comment, for example, is private and then later allow the project maintainer to expose it to the world? Isn't that rather obnoxious?
- Is it simpler to disable karma for private projects rather than deal with the potential for leaks?
The text below is quite old and may no longer relate to this LEP in its current form. This might be like private teams where they are completely invisible except to members. Private teams can be put in a public relationship that reveals it's identifying information, or placed in a trusted relationship that also reveals its members. Private projects might have a public relationship with project groups, but the consequences are scary. Canonical uses project groups to represent organisations, which have a trusted relationship. This feature is not about project groups or organisations, so private projects should not appear in listing or searches to untrusted users. There was a recent discussion where it was not obvious to developers how a user is trusted to see the project. Developers built a policy mechanism that support 3 kinds of trust, but stakeholders only asked for a mechanism to support proprietary development. Either any user in any trusted policy can see all the projects pages, or users just in the proprietary policy can see the project. We also know that proprietary projects do not use embargoed security and user data classifications because their workflows conflict with the need for secrecy. A proprietary project could use all three kinds of trust, but it is using them only within the context of the project. Supporting any trusted policy will reduce setup time for projects that choose to be different from Canonical. In the real world, a project is owned by an organisation that has delegated a maintainer. The organisation
