Skip to content

Commit 2ba51e5

Browse files
J. Keith Bankston [MSFT]Sean Wheeler
authored andcommitted
PSGallery GDPR documentation (#2287)
* Changed required PSGet version to 1.6.0 * Adding GDPR doc Provide info users need to request GDPR data subject requests, and export Gallery data pertaining to them. * Updates from GDPR Staff review Changes made after reviewing doc with Angie Wilson. * Marked code as PowerShell Fixed display issues by marking PS code areas properly. * Updated TOC with GDPR Added GDPR documentation to Gallery TOC. * Fixing typo in PS cmd Minor typo fixed
1 parent 859aa33 commit 2ba51e5

File tree

2 files changed

+92
-0
lines changed

2 files changed

+92
-0
lines changed

gallery/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,8 @@
4747
href: psgallery/psgallery_requires_license_acceptance.md
4848
- name: Require License Acceptance on Deploy to Azure Automation
4949
href: psgallery/psgallery_deploy_to_azure_automation_requireLicenseAcceptance.md
50+
- name: PowerShell Gallery GDPR Compliance
51+
href: psgallery/psgallery_gdpr_dsr.md
5052
- name: PowerShellGet
5153
href: psget/overview.md
5254
items:
Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
---
2+
ms.date: 03/27/2018
3+
contributor: JKeithB
4+
ms.topic: conceptual
5+
keywords: gallery,powershell,psgallery,GDPR
6+
title: PowerShell Gallery GDPR Compliance
7+
---
8+
9+
# PowerShell Gallery GDPR Compliance
10+
11+
## Overview
12+
13+
In May 2018, a European privacy law, the General Data Protection Regulation (GDPR), will take effect.
14+
The GDPR imposes new rules on companies, government agencies, non-profits, and other organizations that offer goods and services to people in the European Union (EU), or that collect and analyze data tied to EU residents. The GDPR applies no matter where you are located.
15+
16+
Microsoft products and services are available today to help you meet the GDPR requirements.
17+
Read more about Microsoft Privacy policy at [Trust Center](https://www.microsoft.com/trustcenter).
18+
19+
The PowerShell Gallery meets GDPR requirements.
20+
21+
The Powershell Gallery stores the following information that may be provided by users, which may contain personal information:
22+
23+
* PowerShell Gallery account
24+
* Items published to the PowerShell Gallery
25+
* Email correspondence with the PowerShell Gallery team
26+
27+
Most users do not create a PowerShell Gallery account, as it is not required unless the user is going to publish an item, or use the "Contact Owner" feature in the PowerShell Gallery.
28+
The PowerShell Gallery does not store EUII data for users who have not created a PowerShell Gallery account, other than email correspondence initiated by the user.
29+
30+
Users who create a PowerShell Gallery account can publish items to the PowerShell Gallery.
31+
Those items are expected to be PowerShell code, but may contain other information including personal information. The information below will show how you can get all the items you have published to the PowerShell Gallery.
32+
33+
34+
## DSR Export of PowerShell Gallery Data
35+
36+
The following sections describe the PowerShell Gallery supports a GDPR Data Subject Request (DSR) by explaining how to export information stored in the PowerShell Gallery, and how to request deletion of this information.
37+
38+
__Email__
39+
40+
Email correspondence may include any of the following:
41+
42+
* Email sent to the owners of PowerShell Gallery items if the code analysis scans detected an issue with any item they have published to the PowerShell Gallery
43+
* Email sent by anyone to the PowerShell Gallery team using the email address in the "Contact Us" page ([email protected])
44+
* Registered users who use the "Contact Owner" feature in the PowerShell Gallery to send email to the owner of an item in the PowerShell Gallery
45+
46+
Emails sent by or to the PowerShell Gallery have a retention policy of 90 days, in order to support possible security investigations should malicious code be discovered on the PowerShell Gallery.
47+
Emails are deleted by policy after 90 days.
48+
49+
Users may request copies of all emails that sent within the previous 90 days to or from the PowerShell Gallery to their email account. This can be done by sending an email to [email protected], with the title: "DSR Request for emails relating to this account", and stating in the body what they are seeking (for example: Please send all emails sent to or received from this email address that you currently have.) All emails involving that email address within 90 days of the request will be sent to the requesting email account within 7 business days.
50+
51+
52+
__PowerShell Gallery Account Information__
53+
54+
If you have created a PowerShell Gallery account, you can find all personal information that has been stored in PowerShell Gallery by taking the following steps:
55+
56+
1. Sign in to the PowerShell Gallery, then click on your username
57+
2. The next page displayed is the Account page, which shows the email address used for the PowerShell Gallery account
58+
59+
If you have created more than one account in the PowerShell Gallery, you will need to repeat these steps for each account.
60+
61+
__Items in the PowerShell Gallery__
62+
63+
To facilitate exporting all versions of all items published to the PowerShell Gallery by an user, users may download the script "GetPSGalleryItemsForAuthor" from the PowerShell Gallery, or from https://github.com/powershell/powershellgallery. This script will export a copy of every version of every item put onto the PowerShell Gallery based on the author information stored in the item. It is important to note that the Author is stored in the item manifest when you publish your item,and is not guaranteed to be the same as the account you use in the PowerShell Gallery. If you use some other value in the Author field, you will need to supply that value when using this script.
64+
65+
You may download the script by using the following PowerShell command:
66+
67+
```powershell
68+
Save-Script GetPSGalleryItemsForAuthor -path <local folder location> -repository psgallery
69+
```
70+
71+
72+
You can then run the script directly, by running the following PowerShell commands:
73+
74+
```powershell
75+
cd <local folder location supplied previously>
76+
.\GetPSGalleryItemsForAuthor.ps1
77+
```
78+
79+
You will be prompted to supply the Author and a folder on your system where you want the items to be saved.
80+
81+
## Deleting Personal Data From The PowerShell Gallery
82+
83+
Users who wish to delete either their PowerShell Gallery account or an item in the PowerShell Gallery must send email to cgadmin with the title: "GDPR Request for items relating to this account", and stating in the body what they are seeking, for example:
84+
85+
* Please delete version x.y.z of my item "item name" _or_
86+
* Please delete all versions of my item "item name" _or_
87+
* Please delete my PowerShell Gallery account
88+
89+
The PowerShell Gallery administrators will reply to the email within 7 business days, and items specified will be deleted within 30 days after the request is sent.
90+

0 commit comments

Comments
 (0)