diff --git a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise.md b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise.md index 39c959973125..98119acfcbd4 100644 --- a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise.md +++ b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise.md @@ -117,11 +117,11 @@ For more information about the audit log REST API, see "[Enterprise administrati ### Example 1: All events in an enterprise, for a specific date, with pagination -You can use page-based pagination or cursor based pagination. For more information, see "[Traversing with Pagination](/rest/guides/traversing-with-pagination)." +You can use page-based pagination or cursor based pagination. For more information about pagination, see "[Using pagination in the REST API](/rest/guides/using-pagination-in-the-rest-api)." #### Example with page-based pagination -The query below searches for audit log events created on Jan 1st, 2022 in the `avocado-corp` enterprise, and return the first page with a maximum of 100 items per page using [REST API pagination](/rest/overview/resources-in-the-rest-api#pagination): +The query below searches for audit log events created on Jan 1st, 2022 in the `avocado-corp` enterprise, and return the first page with a maximum of 100 items per page using pagination. For more information about pagination, see "[Using pagination in the REST API](/rest/guides/using-pagination-in-the-rest-api)." ```shell curl -H "Authorization: Bearer TOKEN" \ @@ -131,7 +131,7 @@ curl -H "Authorization: Bearer TOKEN" \ #### Example with cursor-based pagination -The query below searches for audit log events created on Jan 1st, 2022 in the `avocado-corp` enterprise, and returns the first page with a maximum of 100 items per page using [REST API pagination](/rest/overview/resources-in-the-rest-api#pagination). The `--include` flag causes the headers to be returned along with the response. +The query below searches for audit log events created on Jan 1st, 2022 in the `avocado-corp` enterprise, and returns the first page with a maximum of 100 items per page using pagination. For more information about pagination, see "[Using pagination in the REST API](/rest/guides/using-pagination-in-the-rest-api)." The `--include` flag causes the headers to be returned along with the response. ``` curl --include -H "Authorization: Bearer TOKEN" \ diff --git a/content/rest/guides/best-practices-for-integrators.md b/content/rest/guides/best-practices-for-integrators.md index b444e447d28b..4746ff3531ef 100644 --- a/content/rest/guides/best-practices-for-integrators.md +++ b/content/rest/guides/best-practices-for-integrators.md @@ -61,7 +61,7 @@ Often, API responses contain data in the form of URLs. For example, when request For the stability of your app, you shouldn't try to parse this data or try to guess and construct the format of future URLs. Your app is liable to break if we decide to change the URL. -For example, when working with paginated results, it's often tempting to construct URLs that append `?page=` to the end. Avoid that temptation. [Our guide on pagination](/guides/traversing-with-pagination) offers some safe tips on dependably following paginated results. +For example, when working with paginated results, it's often tempting to construct URLs that append `?page=` to the end. Avoid that temptation. For more information about dependably following paginated results, see "[Using pagination in the REST API](/rest/guides/using-pagination-in-the-rest-api)." ## Check the event type and action before processing the event diff --git a/content/rest/guides/discovering-resources-for-a-user.md b/content/rest/guides/discovering-resources-for-a-user.md index 11f6410042c0..fc9e54b11d6b 100644 --- a/content/rest/guides/discovering-resources-for-a-user.md +++ b/content/rest/guides/discovering-resources-for-a-user.md @@ -30,7 +30,7 @@ In addition to having their own personal repositories, a user may be a collabora [OAuth scopes][scopes] and [organization application policies][oap] determine which of those repositories your app can access for a user. Use the workflow below to discover those repositories. -As always, first we'll require [GitHub's Octokit.rb][octokit.rb] Ruby library. Then we'll configure Octokit.rb to automatically handle [pagination][pagination] for us. +As always, first we'll require [GitHub's Octokit.rb][octokit.rb] Ruby library. Then we'll configure Octokit.rb to automatically handle pagination for us. For more information about pagination, see "[Using pagination in the REST API](/rest/guides/using-pagination-in-the-rest-api)." ``` ruby require 'octokit' @@ -67,7 +67,7 @@ end Applications can perform all sorts of organization-related tasks for a user. To perform these tasks, the app needs an [OAuth authorization][scopes] with sufficient permission. For example, the `read:org` scope allows you to [list teams][list-teams], and the `user` scope lets you [publicize the user’s organization membership][publicize-membership]. Once a user has granted one or more of these scopes to your app, you're ready to fetch the user’s organizations. -Just as we did when discovering repositories above, we'll start by requiring [GitHub's Octokit.rb][octokit.rb] Ruby library and configuring it to take care of [pagination][pagination] for us: +Just as we did when discovering repositories above, we'll start by requiring [GitHub's Octokit.rb][octokit.rb] Ruby library and configuring it to take care of pagination for us. For more information about pagination, see "[Using pagination in the REST API](/rest/guides/using-pagination-in-the-rest-api)." ``` ruby require 'octokit' @@ -105,7 +105,6 @@ As an application, you typically want all of the user's organizations that your [make-authenticated-request-for-user]: /rest/guides/basics-of-authentication#making-authenticated-requests [oap]: https://developer.github.com/changes/2015-01-19-an-integrators-guide-to-organization-application-policies/ [octokit.rb]: https://github.com/octokit/octokit.rb -[pagination]: /rest#pagination [platform samples]: https://github.com/github/platform-samples/tree/master/api/ruby/discovering-resources-for-a-user [publicize-membership]: /rest/reference/orgs#set-public-organization-membership-for-the-authenticated-user [register-oauth-app]: /rest/guides/basics-of-authentication#registering-your-app diff --git a/content/rest/guides/index.md b/content/rest/guides/index.md index a8a810c1c870..25e312b36e70 100644 --- a/content/rest/guides/index.md +++ b/content/rest/guides/index.md @@ -18,7 +18,7 @@ children: - /delivering-deployments - /rendering-data-as-graphs - /working-with-comments - - /traversing-with-pagination + - /using-pagination-in-the-rest-api - /building-a-ci-server - /best-practices-for-integrators - /getting-started-with-the-git-database-api diff --git a/content/rest/guides/traversing-with-pagination.md b/content/rest/guides/traversing-with-pagination.md deleted file mode 100644 index 008346f884a7..000000000000 --- a/content/rest/guides/traversing-with-pagination.md +++ /dev/null @@ -1,350 +0,0 @@ ---- -title: Traversing with pagination -intro: Explore how to use pagination to manage your responses with some examples using the Search API. -redirect_from: - - /guides/traversing-with-pagination - - /v3/guides/traversing-with-pagination -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - API -shortTitle: Traverse with pagination -miniTocMaxHeadingLevel: 3 ---- - -The {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API provides a vast wealth of information for developers to consume. -Most of the time, you might even find that you're asking for _too much_ information, -and in order to keep our servers happy, the API will automatically [paginate the requested items](/rest/overview/resources-in-the-rest-api#pagination). - -In this guide, we'll make some calls to the Search API, and iterate over -the results using pagination. You can find the complete source code for this project -in the [platform-samples][platform samples] repository. - -{% data reusables.rest-api.dotcom-only-guide-note %} - - - -## Basics of Pagination - -To start with, it's important to know a few facts about receiving paginated items: - - -1. Different API calls respond with different defaults. For example, a call to -[List public repositories](/rest/reference/repos#list-public-repositories) -provides paginated items in sets of 30, whereas a call to the GitHub Search API -provides items in sets of 100 -2. You can specify how many items to receive (up to a maximum of 100); but, -3. For technical reasons, not every endpoint behaves the same. For example, -[events](/rest/reference/activity#events) won't let you set a maximum for items to receive. -Be sure to read the documentation on how to handle paginated results for specific endpoints. - -{% note %} - -**Note**: You should always rely on URLs included in the link header. Don't try to guess or construct your own URLs. - -{% endnote %} - - -### Link header - -The response header includes information about pagination. For more information about headers, see "[Getting started with the REST API](/rest/guides/getting-started-with-the-rest-api#about-the-response-code-and-headers)." To get the response header, include the `-I` flag in your request. For example: - -```shell -$ curl -I -H "Accept: application/vnd.github+json" -H "Authorization: Bearer YOUR_TOKEN" https://api.github.com/enterprises/advacado-corp/audit-log - -``` - -The `-I` flag returns only the response header. If the response is paginated, the response header will include a `link` header. The header will look something like this: - -``` -link: ; rel="next" -``` - -or - -``` -link: ; rel="next", ; rel="last" -``` -### Types of pagination - -{% data variables.product.company_short %}'s API uses two pagination methods: page-based pagination and cursor-based pagination. If the `link` header includes `page`, then the operation uses page-based pagination. If the `link` header includes `before` and `after`, then the operation uses cursor-based pagination. - - -#### Page based pagination - -The link header for page-based pagination will tell you information about the previous, next, first, and last pages. If you did not request a specific page, then the response will default to the first page and information about the first and previous pages will be omitted. - -For example, for a request that did not specify a page, this header states that the next page is `2` and the last page is `511`. - -``` -link: ; rel="next", ; rel="last" -``` - -For example, for a request that specified page 5, this header states that the previous page is `4`, the next page is `6`, the last page is `511`, and the first page is `1`. - -``` -link: ; rel="prev", ; rel="next", ; rel="last", ; rel="first" -``` - -#### Cursor based pagination - -Cursor pagination uses terms `before` and `after` in order to navigate through pages. `rel="next"` and `rel="prev"` this mark the cursor point in the data set and provides a reference for traveling to the page `before` and `after` the current page. - -``` -link: ; rel="next", -; rel="first", -; rel="prev" -``` - -In this example, `rel=next` says that the next page is located at: - -``` -after=MS42NjQzODM5MTkzNDdlKzEyfDM0MkI6NDdBNDo4RTFGMEM6NUIyQkZCMzo2MzM0N0JBRg%3D%3D&before= -``` - - - - -### Using pagination - -#### Cursor based pagination - -Using cursor based pagination requires you to use the terms `before` and `after`. To navigate using `before` and `after`, copy the link header generated above into your curl request: - -```shell -$ curl -I -H "Accept: application/vnd.github+json" -H "Authorization: Bearer YOUR_TOKEN" https://api.github.com/enterprises/13827/audit-log?after=MS42NjQzODM5MTkzNDdlKzEyfDM0MkI6NDdBNDo4RTFGMEM6NUIyQkZCMzo2MzM0N0JBRg%3D%3D&before= -``` - -The above example will generate a page of results and new header information that you can use to make the next request. `rel="next"` provides the next page of results. `rel="prev"` provides the previous page of results. The important part of the output here is the link header needs to be generated rather than manually imputed. Copy the entire link from the following output. - -``` -link: ; rel="next", -; rel="first", -; rel="prev" -``` - -Unlike page-based pagination, the results will not return the last page number in the response. - - link: ; rel="next", - ; rel="first", - ; rel="prev" - -Because cursor based pagination creates a reference point in the data set, it cannot calculate the total number of results. - - -#### Page based pagination - -To navigate using page based pagination pass in a `page` -parameter. By default, `page` always starts at `1`. In the following example, we have made a curl request to the search API Mozilla projects use the phrase `addClass`. Instead of starting at 1, lets jump to page 14. - -```shell -$ curl -I "https://api.github.com/search/code?q=addClass+user:mozilla&page=14" -``` - -Here's an except of the link header in the HTTP request: - - Link: ; rel="next", - ; rel="last", - ; rel="first", - ; rel="prev" - -In this example, `rel="next"` is at 15, and `rel="last"` is 34. But now we've -got some more information: `rel="first"` indicates the URL for the _first_ page, -and more importantly, `rel="prev"` lets you know the page number of the previous -page. Using this information, you could construct some UI that lets users jump -between the first, previous, next, or last list of results in an API call. - - -### Changing the number of items received - -#### Page based pagination - -By passing the `per_page` parameter, you can specify how many items you want -each page to return, up to 100 items. Let's try asking for 50 items about `addClass`: - -```shell -$ curl -I "https://api.github.com/search/code?q=addClass+user:mozilla&per_page=50" -``` - -Notice what it does to the header response: - - Link: ; rel="next", - ; rel="last" - -As you might have guessed, the `rel="last"` information says that the last page -is now 20. This is because we are asking for more information per page about -our results. - -#### Cursor based pagination - -You can also pass the `per_page` parameter for cursor-based pagination. - -```shell -$ curl -I -H "Accept: application/vnd.github+json" -H "Authorization: Bearer YOUR_TOKEN" https://api.github.com/enterprises/13827/audit-log?after=MS42NjQzODM5MTkzNDdlKzEyfDM0MkI6NDdBNDo4RTFGMEM6NUIyQkZCMzo2MzM0N0JBRg%3D%3D&before=&per_page=50 -``` - -## Consuming the information - -You don't want to be making low-level curl calls just to be able to work with -pagination, so let's write a little Ruby script that does everything we've -just described above. - -As always, first we'll require [GitHub's Octokit.rb][octokit.rb] Ruby library, and -pass in our [{% data variables.product.pat_generic %}][personal token]: - -``` ruby -require 'octokit' - -# !!! DO NOT EVER USE HARD-CODED VALUES IN A REAL APP !!! -# Instead, set and test environment variables, like below -client = Octokit::Client.new :access_token => ENV['MY_PERSONAL_TOKEN'] -``` - -Next, we'll execute the search, using Octokit's `search_code` method. Unlike -using `curl`, we can also immediately retrieve the number of results, so let's -do that: - -``` ruby -results = client.search_code('addClass user:mozilla') -total_count = results.total_count -``` - -Now, let's grab the number of the last page, similar to `page=34>; rel="last"` -information in the link header. Octokit.rb support pagination information through -an implementation called "[Hypermedia link relations][hypermedia-relations]." -We won't go into detail about what that is, but, suffice to say, each element -in the `results` variable has a hash called `rels`, which can contain information -about `:next`, `:last`, `:first`, and `:prev`, depending on which result you're -on. These relations also contain information about the resulting URL, by calling -`rels[:last].href`. - -Knowing this, let's grab the page number of the last result, and present all -this information to the user: - -``` ruby -last_response = client.last_response -number_of_pages = last_response.rels[:last].href.match(/page=(\d+).*$/)[1] - -puts "There are #{total_count} results, on #{number_of_pages} pages!" -``` - -Finally, let's iterate through the results. You could do this with a loop `for i in 1..number_of_pages.to_i`, -but instead, let's follow the `rels[:next]` headers to retrieve information from -each page. For the sake of simplicity, let's just grab the file path of the first -result from each page. To do this, we'll need a loop; and at the end of every loop, -we'll retrieve the data set for the next page by following the `rels[:next]` information. -The loop will finish when there is no `rels[:next]` information to consume (in other -words, we are at `rels[:last]`). It might look something like this: - -``` ruby -puts last_response.data.items.first.path -until last_response.rels[:next].nil? - last_response = last_response.rels[:next].get - puts last_response.data.items.first.path -end -``` - -Changing the number of items per page is extremely simple with Octokit.rb. Simply -pass a `per_page` options hash to the initial client construction. After that, -your code should remain intact: - -``` ruby -require 'octokit' - -# !!! DO NOT EVER USE HARD-CODED VALUES IN A REAL APP !!! -# Instead, set and test environment variables, like below -client = Octokit::Client.new :access_token => ENV['MY_PERSONAL_TOKEN'] - -results = client.search_code('addClass user:mozilla', :per_page => 100) -total_count = results.total_count - -last_response = client.last_response -number_of_pages = last_response.rels[:last].href.match(/page=(\d+).*$/)[1] - -puts last_response.rels[:last].href -puts "There are #{total_count} results, on #{number_of_pages} pages!" - -puts "And here's the first path for every set" - -puts last_response.data.items.first.path -until last_response.rels[:next].nil? - last_response = last_response.rels[:next].get - puts last_response.data.items.first.path -end -``` - -## Constructing Pagination Links - -Normally, with pagination, your goal isn't to concatenate all of the possible -results, but rather, to produce a set of navigation, like this: - -![Sample of pagination links](/assets/images/pagination_sample.png) - -Let's sketch out a micro-version of what that might entail. - -From the code above, we already know we can get the `number_of_pages` in the -paginated results from the first call: - -``` ruby -require 'octokit' - -# !!! DO NOT EVER USE HARD-CODED VALUES IN A REAL APP !!! -# Instead, set and test environment variables, like below -client = Octokit::Client.new :access_token => ENV['MY_PERSONAL_TOKEN'] - -results = client.search_code('addClass user:mozilla') -total_count = results.total_count - -last_response = client.last_response -number_of_pages = last_response.rels[:last].href.match(/page=(\d+).*$/)[1] - -puts last_response.rels[:last].href -puts "There are #{total_count} results, on #{number_of_pages} pages!" -``` - -From there, we can construct a beautiful ASCII representation of the number boxes: -``` ruby -numbers = "" -for i in 1..number_of_pages.to_i - numbers << "[#{i}] " -end -puts numbers -``` - -Let's simulate a user clicking on one of these boxes, by constructing a random -number: - -``` ruby -random_page = Random.new -random_page = random_page.rand(1..number_of_pages.to_i) - -puts "A User appeared, and clicked number #{random_page}!" -``` - -Now that we have a page number, we can use Octokit to explicitly retrieve that -individual page, by passing the `:page` option: - -``` ruby -clicked_results = client.search_code('addClass user:mozilla', :page => random_page) -``` - -If we wanted to get fancy, we could also grab the previous and next pages, in -order to generate links for back (`<<`) and forward (`>>`) elements: - -``` ruby -prev_page_href = client.last_response.rels[:prev] ? client.last_response.rels[:prev].href : "(none)" -next_page_href = client.last_response.rels[:next] ? client.last_response.rels[:next].href : "(none)" - -puts "The prev page link is #{prev_page_href}" -puts "The next page link is #{next_page_href}" -``` - -[pagination]: /rest#pagination -[platform samples]: https://github.com/github/platform-samples/tree/master/api/ruby/traversing-with-pagination -[octokit.rb]: https://github.com/octokit/octokit.rb -[personal token]: /articles/creating-an-access-token-for-command-line-use -[hypermedia-relations]: https://github.com/octokit/octokit.rb#pagination -[listing commits]: /rest/reference/commits#list-commits diff --git a/content/rest/guides/using-pagination-in-the-rest-api.md b/content/rest/guides/using-pagination-in-the-rest-api.md new file mode 100644 index 000000000000..e22feff99d60 --- /dev/null +++ b/content/rest/guides/using-pagination-in-the-rest-api.md @@ -0,0 +1,180 @@ +--- +title: Using pagination in the REST API +intro: Learn how to navigate through paginated responses from the REST API. +redirect_from: + - /guides/traversing-with-pagination + - /v3/guides/traversing-with-pagination + - /rest/guides/traversing-with-pagination +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +topics: + - API +shortTitle: Pagination +miniTocMaxHeadingLevel: 3 +--- + +## About pagination + +When a response from the REST API would include many results, {% data variables.product.company_short %} will paginate the results and return a subset of the results. For example, `GET /repos/octocat/Spoon-Knife/issues` will only return 30 issues from the `octocat/Spoon-Knife` repository even though the repository includes over 1600 open issues. This makes the response easier to handle for servers and for people. + +This guide demonstrates how to request additional pages of results for paginated responses, how to change the number of results returned on each page, and how to write a script to fetch multiple pages of results. + +## Using link headers + +When a response is paginated, the response headers will include a link header. The link header will be omitted if the endpoint does not support pagination or if all results fit on a single page. The link header contains URLs that you can used to fetch additional pages of results. To see the response headers if you are using curl or {% data variables.product.prodname_cli %}, pass the `--include` flag with your request. To see the response headers if you are using a library to make requests, follow the documentation for that library. For example: + +```shell +curl --include --request GET \ +--url "https://api.github.com/repos/octocat/Spoon-Knife/issues" \ +--header "Accept: application/vnd.github+json" +``` + +If the response is paginated, the link header will look something like this: + +``` +link: ; rel="prev", ; rel="next", ; rel="last", ; rel="first" +``` + +The link header provides the URL for the previous, next, first, and last page of results: + +- The URL for the previous page is followed by `rel="prev"`. +- The URL for the next page is followed by `rel="next"`. +- The URL for the last page is followed by `rel="last"`. +- The URL for the first page is followed by `rel="first"`. + +In some cases, only a subset of these links are available. For example, the link to the previous page won't be included if you are on the first page of results, and the link to the last page won't be included if it can't be calculated. + +You can use the URLs from the link header to request another page of results. For example, to request the last page of results based on the previous example: + +```shell +curl --include --request GET \ +--url "https://api.github.com/repositories/1300192/issues?page=515" \ +--header "Accept: application/vnd.github+json" +``` + +The URLs in the link header use query parameters to indicate what page of results to return. The query parameters in the link URLs may differ between endpoints: each paginated endpoint will use the `page`, `before`/`after`, or `since` query parameters. (Some endpoints use the `since` parameter for something other than pagination.) In all cases, you can use the URLs in the link header to fetch additional pages of results. For more information about query parameters see "[Getting started with the REST API](/rest/guides/getting-started-with-the-rest-api#using-query-parameters)." + +## Changing the number of items per page + +If an endpoint supports the `per_page` query parameter, then you can control how many results are returned on a page. For more information about query parameters see "[Getting started with the REST API](/rest/guides/getting-started-with-the-rest-api#using-query-parameters)." + +For example, this request uses the `per_page` query parameter to return two items per page: + +```shell +curl --include --request GET \ +--url "https://api.github.com/repos/octocat/Spoon-Knife/issues?per_page=2" \ +--header "Accept: application/vnd.github+json" +``` + +The `per_page` parameter will automatically be included in the link header. For example: + +``` +link: ; rel="next", ; rel="last" +``` + +## Scripting with pagination + +Instead of manually copying URLs from the link header, you can write a script to fetch multiple pages of results. + +The following examples use JavaScript and {% data variables.product.company_short %}'s Octokit.js library. For more information about Octokit.js, see "[Getting started with the REST API](/rest/guides/getting-started-with-the-rest-api?tool=javascript)" and [the Octokit.js README](https://github.com/octokit/octokit.js/#readme). + +### Example using the Octokit.js pagination method + +To fetch paginated results with Octokit.js, you can use `octokit.paginate()`. `octokit.paginate()` will fetch the next page of results until it reaches the last page and then return all of the results as a single array. A few endpoints return paginated results as array in an object, as opposed to returning the paginated results as an array. `octokit.paginate()` always returns an array of items even if the raw result was an object. If the results are not paginated, `octokit.paginate()` will behave like `octokit.request()`. + +For example, this script gets all of the issues from the `octocat/Spoon-Knife` repository. Although it requests 100 issues at a time, the function won't return until the last page of data is reached. + +```javascript{:copy} +import { Octokit } from "octokit"; + +const octokit = new Octokit({ {% ifversion ghes or ghae %} + baseUrl: "{% data variables.product.api_url_code %}", +{% endif %}}); + +const data = await octokit.paginate("GET /repos/{owner}/{repo}/issues", { + owner: "octocat", + repo: "Spoon-Knife", + per_page: 100,{% ifversion api-date-versioning %} + headers: { + "X-GitHub-Api-Version": "{{ allVersions[currentVersion].latestApiVersion }}", + },{% endif %} +}); + +console.log(data) +``` + +You can pass an optional map function to `octokit.paginate()` to end pagination before the last page is reached or to reduce memory usage by keeping only a subset of the response. You can also use `octokit.paginate.iterator()` to iterate through a single page at a time instead of requesting every page. For more information, see [the Octokit.js documentation](https://github.com/octokit/octokit.js#pagination). + +### Example creating a pagination method + +If you are using another language or library that doesn't have a pagination method, you can build your own pagination method. This example still uses the Octokit.js library to make requests, but does not rely on `octokit.paginate()`. + +The `getPaginatedData` function makes a request to an endpoint with `octokit.request()`. The data from the response is processed by `parseData`, which handles cases where no data is returned or cases where the data that is returned is an object instead of an array. The processed data is then appended to a list that contains all of the paginated data collected so far. If the response includes a link header and if the link header includes a link for the next page, then the function uses a RegEx pattern (`nextPattern`) to get the URL for the next page. The function then repeats the previous steps, now using this new URL. Once the link header no longer includes a link to the next page, all of the results are returned. + +```javascript{:copy} +import { Octokit } from "octokit"; + +const octokit = new Octokit({ {% ifversion ghes or ghae %} + baseUrl: "{% data variables.product.api_url_code %}", +{% endif %}}); + +async function getPaginatedData(url) { + const nextPattern = /(?<=<)([\S]*)(?=>; rel="Next")/i; + let pagesRemaining = true; + let data = []; + + while (pagesRemaining) { + const response = await octokit.request(`GET ${url}`, { + per_page: 100,{% ifversion api-date-versioning %} + headers: { + "X-GitHub-Api-Version": + "{{ allVersions[currentVersion].latestApiVersion }}", + },{% endif %} + }); + + const parsedData = parseData(response.data) + data = [...data, ...parsedData]; + + const linkHeader = response.headers.link; + + pagesRemaining = linkHeader && linkHeader.includes(`rel=\"next\"`); + + if (pagesRemaining) { + url = linkHeader.match(nextPattern)[0]; + } + } + + return data; +} + +function parseData(data) { + // If the data is an array, return that + if (Array.isArray(data)) { + return data + } + + // Some endpoints respond with 204 No Content instead of empty array + // when there is no data. In that case, return an empty array. + if (!data) { + return [] + } + + // Otherwise, the array of items that we want is in an object + // Delete keys that don't include the array of items + delete data.incomplete_results; + delete data.repository_selection; + delete data.total_count; + // Pull out the array of items + const namespaceKey = Object.keys(data)[0]; + data = data[namespaceKey]; + + return data; +} + +const data = await getPaginatedData("/repos/octocat/Spoon-Knife/issues"); + +console.log(data); +``` diff --git a/content/rest/index.md b/content/rest/index.md index 8b061af0f31a..762760e8d0c7 100644 --- a/content/rest/index.md +++ b/content/rest/index.md @@ -10,6 +10,7 @@ featuredLinks: - /rest/guides/getting-started-with-the-rest-api - /rest/guides/basics-of-authentication - /rest/guides/best-practices-for-integrators + - /rest/guides/using-pagination-in-the-rest-api popular: - /rest/overview/resources-in-the-rest-api - /rest/overview/api-versions diff --git a/content/rest/overview/resources-in-the-rest-api.md b/content/rest/overview/resources-in-the-rest-api.md index 9a1a2900eae7..72517b3318d7 100644 --- a/content/rest/overview/resources-in-the-rest-api.md +++ b/content/rest/overview/resources-in-the-rest-api.md @@ -303,54 +303,7 @@ gem: ## Pagination -Requests that return multiple items will be paginated to 30 items by -default. You can specify further pages with the `page` parameter. For some -resources, you can also set a custom page size up to 100 with the `per_page` parameter. -Note that for technical reasons not all endpoints respect the `per_page` parameter, -see [events](/rest/reference/activity#events) for example. - -```shell -$ curl '{% data variables.product.api_url_pre %}/user/repos?page=2&per_page=100' -``` - -Note that page numbering is 1-based and that omitting the `page` -parameter will return the first page. - -Some endpoints use cursor-based pagination. A cursor is a string that points to a location in the result set. -With cursor-based pagination, there is no fixed concept of "pages" in the result set, so you can't navigate to a specific page. -Instead, you can traverse the results by using the `before` or `after` parameters. - -For more information on pagination, check out our guide on [Traversing with Pagination][pagination-guide]. - -### Link header - -{% note %} - -**Note:** It's important to form calls with Link header values instead of constructing your own URLs. - -{% endnote %} - -The [Link header](https://datatracker.ietf.org/doc/html/rfc5988) includes pagination information. For example: - - Link: <{% data variables.product.api_url_code %}/user/repos?page=3&per_page=100>; rel="next", - <{% data variables.product.api_url_code %}/user/repos?page=50&per_page=100>; rel="last" - -_The example includes a line break for readability._ - -Or, if the endpoint uses cursor-based pagination: - - Link: <{% data variables.product.api_url_code %}/orgs/ORG/audit-log?after=MTYwMTkxOTU5NjQxM3xZbGI4VE5EZ1dvZTlla09uWjhoZFpR&before=>; rel="next", - -This `Link` response header contains one or more [Hypermedia](/rest#hypermedia) link relations, some of which may require expansion as [URI templates](https://datatracker.ietf.org/doc/html/rfc6570). - -The possible `rel` values are: - -Name | Description ------------|-----------| -`next` |The link relation for the immediate next page of results. -`last` |The link relation for the last page of results. -`first` |The link relation for the first page of results. -`prev` |The link relation for the immediate previous page of results. +When a response from the REST API would include many results, {% data variables.product.company_short %} will paginate the results and return a subset of the results. You can use the link header from the response to request additional pages of data. If an endpoint supports the `per_page` query parameter, then you can control how many results are returned on a page. For more information about pagination, see "[Using pagination in the REST API](/rest/guides/using-pagination-in-the-rest-api)." ## Timeouts @@ -723,5 +676,3 @@ If no `Time-Zone` header is specified and you make an authenticated call to the ### Defaulting to UTC without other timezone information If the steps above don't result in any information, we use UTC as the timezone to create the git commit. - -[pagination-guide]: /guides/traversing-with-pagination diff --git a/content/rest/overview/troubleshooting.md b/content/rest/overview/troubleshooting.md index 57e7fe3c7518..4045debe8aaf 100644 --- a/content/rest/overview/troubleshooting.md +++ b/content/rest/overview/troubleshooting.md @@ -51,7 +51,7 @@ in order to get more results. It's important to *not* try and guess the format of the pagination URL. Not every API call uses the same structure. Instead, extract the pagination information from -[the Link Header](/rest#pagination), which is sent with every request. +the link header, which is returned with every request. For more information about pagination, see "[Using pagination in the REST API](/rest/guides/using-pagination-in-the-rest-api)." [oap-guide]: https://developer.github.com/changes/2015-01-19-an-integrators-guide-to-organization-application-policies/ diff --git a/data/reusables/rest-api/dotcom-only-guide-note.md b/data/reusables/rest-api/dotcom-only-guide-note.md deleted file mode 100644 index 86e1a648f12b..000000000000 --- a/data/reusables/rest-api/dotcom-only-guide-note.md +++ /dev/null @@ -1,13 +0,0 @@ -{% ifversion not fpt or ghec %} - -{% note %} - -**Note**: The following guide uses the REST API for {% data variables.product.prodname_dotcom_the_website %}. - -- Use {% data variables.product.api_url_pre %} to access the API for {% data variables.product.product_name %}. - -- The guide specifies usernames and repositories that may not exist on {% data variables.location.product_location %}. You may need to use different names to see similar output. - -{% endnote %} - -{% endif %} diff --git a/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-amazon-s3-storage.md b/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-amazon-s3-storage.md index d2a1f669d573..e8be9e34f993 100644 --- a/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-amazon-s3-storage.md +++ b/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-amazon-s3-storage.md @@ -1,6 +1,6 @@ --- -title: Habilitar las GitHub Actions con el almacenamiento de Amazon S3 -intro: 'Puedes habilitar {% data variables.product.prodname_actions %} en {% data variables.product.prodname_ghe_server %} y utilizar el almacenamiento de Amazon S3 para almacenar datos generados por ejecuciones de flujos de trabajo.' +title: Enabling GitHub Actions with Amazon S3 storage +intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use Amazon S3 storage to store data generated by workflow runs.' permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.' versions: ghes: '*' @@ -13,40 +13,42 @@ topics: redirect_from: - /admin/github-actions/enabling-github-actions-with-amazon-s3-storage shortTitle: Amazon S3 storage -ms.openlocfilehash: 23fd8eabe502a6a29610de451cae72542ceca53f -ms.sourcegitcommit: 8f7c8d52755cc3af0f366cc74c6db9e9be4d2ecd -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/04/2022 -ms.locfileid: '148132652' --- -## Prerrequisitos + +{% data reusables.actions.enterprise-storage-about %} + +## Prerequisites {% note %} -**Advertencia:** Los únicos proveedores de almacenamiento de S3 compatibles con {% data variables.product.prodname_dotcom %} son Amazon S3 y MinIO Gateway for NAS. +**Note:** The only {% data variables.product.prodname_dotcom %}-supported S3 storage providers are Amazon S3 and MinIO Gateway for NAS. {% data reusables.actions.enterprise-s3-tech-partners %} {% endnote %} -Antes de que habilites las {% data variables.product.prodname_actions %}, asegúrate de que has completado los siguientes pasos: +Before enabling {% data variables.product.prodname_actions %}, make sure you have completed the following steps: -* Crea tu cubo de Amazon S3 para almacenar los datos que generan las ejecuciones de flujo de trabajo. {% indented_data_reference reusables.actions.enterprise-s3-permission spaces=2 %} +* Create your Amazon S3 bucket for storing data generated by workflow runs. {% indented_data_reference reusables.actions.enterprise-s3-permission spaces=2 %} {% data reusables.actions.enterprise-common-prereqs %} -## Habilitar {% data variables.product.prodname_actions %} con almacenamiento de Amazon S3 +## Enabling {% data variables.product.prodname_actions %} with Amazon S3 storage -{% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.actions %} {% data reusables.actions.enterprise-enable-checkbox %} -1. En "Artifact & Log Storage" (Almacenamiento de artefactos y registros), seleccione **Amazon S3** y escriba los detalles del cubo de almacenamiento: +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.management-console %} +{% data reusables.enterprise_management_console.actions %} +{% data reusables.actions.enterprise-enable-checkbox %} +1. Under "Artifact & Log Storage", select **Amazon S3**, and enter your storage bucket's details: - * **URL del servicio de AWS**: la dirección URL del servicio del cubo. Por ejemplo, si el cubo de S3 se ha creado en la región `us-west-2`, este valor debe ser `https://s3.us-west-2.amazonaws.com`. + * **AWS Service URL**: The service URL for your bucket. For example, if your S3 bucket was created in the `us-west-2` region, this value should be `https://s3.us-west-2.amazonaws.com`. - Para más información, vea "[Puntos de conexión del servicio AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html)" en la documentación de AWS. - * **AWS S3 Bucket** (Cubo de AWS S3): nombre del cubo de S3. - * **AWS S3 Access Key** y **AWS S3 Secret Key**: el identificador de clave de acceso de AWS y la clave secreta para el cubo. Para más información sobre cómo administrar las claves de acceso de AWS,vea la "[documentación sobre administración de identidades y accesos de AWS](https://docs.aws.amazon.com/iam/index.html)". + For more information, see "[AWS service endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html)" in the AWS documentation. + * **AWS S3 Bucket**: The name of your S3 bucket. + * **AWS S3 Access Key** and **AWS S3 Secret Key**: The AWS access key ID and secret key for your bucket. For more information on managing AWS access keys, see the "[AWS Identity and Access Management Documentation](https://docs.aws.amazon.com/iam/index.html)." - ![Botón de radio para seleccionar Amazon S3 Storage y campos para la configuración de S3](/assets/images/enterprise/management-console/actions-aws-s3-storage.png) {% data reusables.enterprise_management_console.test-storage-button %} {% data reusables.enterprise_management_console.save-settings %} + ![Radio button for selecting Amazon S3 Storage and fields for S3 configuration](/assets/images/enterprise/management-console/actions-aws-s3-storage.png) +{% data reusables.enterprise_management_console.test-storage-button %} +{% data reusables.enterprise_management_console.save-settings %} {% data reusables.actions.enterprise-postinstall-nextsteps %} diff --git a/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-azure-blob-storage.md b/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-azure-blob-storage.md index 62b35a6e9dae..b4ab085c79fa 100644 --- a/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-azure-blob-storage.md +++ b/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-azure-blob-storage.md @@ -1,6 +1,6 @@ --- -title: Habilitar las GitHub Actions con el almacenamiento de Azure Blob -intro: 'Puedes habilitar {% data variables.product.prodname_actions %} en {% data variables.product.prodname_ghe_server %} y utilizar Azure Blob Storage para almacenar datos generados por ejecuciones de flujos de trabajo.' +title: Enabling GitHub Actions with Azure Blob storage +intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use Azure Blob storage to store data generated by workflow runs.' permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.' versions: ghes: '*' @@ -13,35 +13,37 @@ topics: redirect_from: - /admin/github-actions/enabling-github-actions-with-azure-blob-storage shortTitle: Azure Blob storage -ms.openlocfilehash: b6abccdfea0d33b387fc3ec6df563fcbaf57f861 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148110029' --- -## Prerrequisitos -Antes de que habilites las {% data variables.product.prodname_actions %}, asegúrate de que has completado los siguientes pasos: +{% data reusables.actions.enterprise-storage-about %} -* Crea tu cuenta de Azure Storage para almacenar datos del flujo de trabajo. {% data variables.product.prodname_actions %} almacena sus datos como blobs de bloque y son compatibles dos tipos de cuenta de almacenamiento: - * Una cuenta de almacenamiento de **uso general** (también conocida como `general-purpose v1` o `general-purpose v2`) que usa el nivel de rendimiento **estándar**. +## Prerequisites + +Before enabling {% data variables.product.prodname_actions %}, make sure you have completed the following steps: + +* Create your Azure storage account for storing workflow data. {% data variables.product.prodname_actions %} stores its data as block blobs, and two storage account types are supported: + * A **general-purpose** storage account (also known as `general-purpose v1` or `general-purpose v2`) using the **standard** performance tier. {% warning %} - **Advertencia:** No se admite el uso del nivel de rendimiento **prémium** con una cuenta de almacenamiento de uso general. El nivel de rendimiento **estándar** se debe seleccionar cuando se crea la cuenta de almacenamiento y no se puede cambiar después. + **Warning:** Using the **premium** performance tier with a general-purpose storage account is not supported. The **standard** performance tier must be selected when creating the storage account, and it cannot be changed later. {% endwarning %} - * Una cuenta de almacenamiento de **BlockBlobStorage** con un nivel de rendimiento **prémium**. + * A **BlockBlobStorage** storage account, which uses the **premium** performance tier. - Para obtener más información sobre los tipos de cuentas de almacenamiento de Azure y los niveles de rendimiento, consulte la [documentación de Azure](https://docs.microsoft.com/en-us/azure/storage/common/storage-account-overview?toc=/azure/storage/blobs/toc.json#types-of-storage-accounts). + For more information on Azure storage account types and performance tiers, see the [Azure documentation](https://docs.microsoft.com/en-us/azure/storage/common/storage-account-overview?toc=/azure/storage/blobs/toc.json#types-of-storage-accounts). {% data reusables.actions.enterprise-common-prereqs %} -## Habilitar las {% data variables.product.prodname_actions %} con el almacenamiento de Blobs de Azure +## Enabling {% data variables.product.prodname_actions %} with Azure Blob storage -{% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.actions %} {% data reusables.actions.enterprise-enable-checkbox %} -1. En "Artifact & Log Storage" (Almacenamiento de artefactos y registros), seleccione **Azure Blob Storage** y escriba la cadena de conexión de la cuenta de almacenamiento de Azure. Para más información sobre cómo obtener la cadena de conexión de la cuenta de almacenamiento, consulte la [documentación de Azure](https://docs.microsoft.com/en-us/azure/storage/common/storage-account-keys-manage?tabs=azure-portal#view-account-access-keys). +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.management-console %} +{% data reusables.enterprise_management_console.actions %} +{% data reusables.actions.enterprise-enable-checkbox %} +1. Under "Artifact & Log Storage", select **Azure Blob Storage**, and enter your Azure storage account's connection string. For more information on getting the connection string for your storage account, see the [Azure documentation](https://docs.microsoft.com/en-us/azure/storage/common/storage-account-keys-manage?tabs=azure-portal#view-account-access-keys). - ![Botón de radio para seleccionar Azure Blob Storage y el campo Cadena de conexión](/assets/images/enterprise/management-console/actions-azure-storage.png) {% data reusables.enterprise_management_console.test-storage-button %} {% data reusables.enterprise_management_console.save-settings %} + ![Radio button for selecting Azure Blob Storage and the Connection string field](/assets/images/enterprise/management-console/actions-azure-storage.png) +{% data reusables.enterprise_management_console.test-storage-button %} +{% data reusables.enterprise_management_console.save-settings %} {% data reusables.actions.enterprise-postinstall-nextsteps %} diff --git a/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-google-cloud-storage.md b/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-google-cloud-storage.md index 7640f12d0869..767521ace0d4 100644 --- a/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-google-cloud-storage.md +++ b/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-google-cloud-storage.md @@ -1,9 +1,9 @@ --- -title: Habilitación de Acciones de GitHub con Google Cloud Storage -intro: 'Puedes habilitar {% data variables.product.prodname_actions %} en {% data variables.product.prodname_ghe_server %} y utilizar Google Cloud Storage para almacenar los datos que generan las ejecuciones de flujos de trabajo.' +title: Enabling GitHub Actions with Google Cloud Storage +intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use Google Cloud Storage to store data generated by workflow runs.' permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.' versions: - feature: actions-ghes-gcp-storage + feature: 'actions-ghes-gcp-storage' type: how_to topics: - Actions @@ -11,27 +11,24 @@ topics: - Infrastructure - Storage shortTitle: Google Cloud Storage -ms.openlocfilehash: abbac860ed3f6f1caaec1152b426762535b8fba4 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148110097' --- + {% note %} -**Nota**: La compatibilidad de {% data variables.product.prodname_actions %} con Google Cloud Storage se encuentra actualmente en versión beta y está sujeta a cambios. +**Note:** {% data variables.product.prodname_actions %} support for Google Cloud Storage is currently in beta and subject to change. {% endnote %} -## Requisitos previos +{% data reusables.actions.enterprise-storage-about %} + +## Prerequisites -Antes de que habilites las {% data variables.product.prodname_actions %}, asegúrate de que has completado los siguientes pasos: +Before enabling {% data variables.product.prodname_actions %}, make sure you have completed the following steps: -* Crea tu cubo de Google Cloud Storage para almacenar los datos que generan las ejecuciones de flujos de trabajo. -* Crea una cuenta de servicio de Google Cloud que pueda acceder al cubo y una clave de código de autenticación de mensajes (HMAC) basada en hash para la cuenta de servicio. Para obtener más información, consulta "[Administración de claves HMAC para las cuentas de servicio](https://cloud.google.com/storage/docs/authentication/managing-hmackeys)" en la documentación de Google Cloud. +* Create your Google Cloud Storage bucket for storing data generated by workflow runs. +* Create a Google Cloud service account that can access the bucket, and create a Hash-based Message Authentication Code (HMAC) key for the service account. For more information, see "[Manage HMAC keys for service accounts](https://cloud.google.com/storage/docs/authentication/managing-hmackeys)" in the Google Cloud documentation. - La cuenta de servicio debe tener los siguientes [permisos de Administración de identidad y acceso (IAM)](https://cloud.google.com/storage/docs/access-control/iam-permissions) para el cubo: + The service account must have the following [Identity and Access Management (IAM) permissions](https://cloud.google.com/storage/docs/access-control/iam-permissions) for the bucket: * `storage.objects.create` * `storage.objects.get` @@ -41,17 +38,23 @@ Antes de que habilites las {% data variables.product.prodname_actions %}, asegú * `storage.multipartUploads.create` * `storage.multipartUploads.abort` * `storage.multipartUploads.listParts` - * `storage.multipartUploads.list` {% data reusables.actions.enterprise-common-prereqs %} + * `storage.multipartUploads.list` +{% data reusables.actions.enterprise-common-prereqs %} -## Habilitación de {% data variables.product.prodname_actions %} con Google Cloud Storage +## Enabling {% data variables.product.prodname_actions %} with Google Cloud Storage -{% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.actions %} {% data reusables.actions.enterprise-enable-checkbox %} -1. En "Almacenamiento de artefactos y registros", selecciona **Google Could Storage** y escribe los detalles del cubo: +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.management-console %} +{% data reusables.enterprise_management_console.actions %} +{% data reusables.actions.enterprise-enable-checkbox %} +1. Under "Artifact & Log Storage", select **Google Cloud Storage**, and enter your bucket's details: - * **URL del servicio**: la dirección URL del servicio del cubo. Normalmente es `https://storage.googleapis.com`. - * **Nombre del cubo**: el nombre del cubo. - * **Id. de acceso de HMAC** y **Secreto de HMAC**: el id. de acceso y el secreto de Google Cloud para la cuenta de almacenamiento. Para obtener más información, consulta "[Administración de claves HMAC para las cuentas de servicio](https://cloud.google.com/storage/docs/authentication/managing-hmackeys)" en la documentación de Google Cloud. + * **Service URL**: The service URL for your bucket. This is usually `https://storage.googleapis.com`. + * **Bucket Name**: The name of your bucket. + * **HMAC Access Id** and **HMAC Secret**: The Google Cloud access ID and secret for your storage account. For more information, see "[Manage HMAC keys for service accounts](https://cloud.google.com/storage/docs/authentication/managing-hmackeys)" in the Google Cloud documentation. - ![Botón de radio para seleccionar Google Cloud Storage y campos para la configuración](/assets/images/enterprise/management-console/actions-google-cloud-storage.png) {% data reusables.enterprise_management_console.test-storage-button %} {% data reusables.enterprise_management_console.save-settings %} + ![Radio button for selecting Google Cloud Storage and fields for configuration](/assets/images/enterprise/management-console/actions-google-cloud-storage.png) +{% data reusables.enterprise_management_console.test-storage-button %} +{% data reusables.enterprise_management_console.save-settings %} {% data reusables.actions.enterprise-postinstall-nextsteps %} diff --git a/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md b/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md index bcb87587cc71..c5a4008e1f23 100644 --- a/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md +++ b/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md @@ -1,6 +1,6 @@ --- -title: Habilitación de Acciones de GitHub con almacenamiento de MinIO -intro: 'Puedes habilitar {% data variables.product.prodname_actions %} en {% data variables.product.prodname_ghe_server %} y utilizar el almacenamiento de MinIO para almacenar datos generados por las ejecuciones de flujos de trabajo.' +title: Enabling GitHub Actions with MinIO storage +intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use MinIO storage to store data generated by workflow runs.' permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.' versions: ghes: '*' @@ -14,35 +14,38 @@ redirect_from: - /admin/github-actions/enabling-github-actions-with-minio-gateway-for-nas-storage - /admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-gateway-for-nas-storage shortTitle: MinIO storage -ms.openlocfilehash: 3d9c6cfca6b81a66185515c8757cef22290ead30 -ms.sourcegitcommit: 8f1801040a84ca9353899a2d1e6782c702aaed0d -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/16/2022 -ms.locfileid: '148166573' --- -## Requisitos previos -Antes de que habilites las {% data variables.product.prodname_actions %}, asegúrate de que has completado los siguientes pasos: +{% data reusables.actions.enterprise-storage-about %} -* Crea tu cubo de MinIO para almacenar los datos que generan las ejecuciones de flujo de trabajo. Para obtener más información sobre cómo instalar y configurar MinIO, consulta: "[Almacenamiento de objetos de alto rendimiento de MinIO ](https://min.io/docs/minio/container/index.html)" y "[mc mb](https://min.io/docs/minio/linux/reference/minio-mc/mc-mb.html)" en la documentación de MinIO. +## Prerequisites - Para evitar la contención de recursos en el dispositivo, te recomendamos que hospedes MinIO separado de {% data variables.location.product_location %}. +Before enabling {% data variables.product.prodname_actions %}, make sure you have completed the following steps: - {% indented_data_reference reusables.actions.enterprise-s3-permission spaces=2 %} {% data reusables.actions.enterprise-common-prereqs %} +* Create your MinIO bucket for storing data generated by workflow runs. For more information about installing and configuring MinIO, see "[MinIO High Performance Object Storage](https://min.io/docs/minio/container/index.html)" and "[mc mb](https://min.io/docs/minio/linux/reference/minio-mc/mc-mb.html)" in the MinIO documentation. -## Habilitar {% data variables.product.prodname_actions %} mediante el almacenamiento de MinIO + To avoid resource contention on the appliance, we recommend that MinIO be hosted separately from {% data variables.location.product_location %}. -{% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.actions %} {% data reusables.actions.enterprise-enable-checkbox %} -1. En "Artifact & Log Storage" (Almacenamiento de artefactos y registros), seleccione **Amazon S3** y escriba los detalles del cubo de almacenamiento: + {% indented_data_reference reusables.actions.enterprise-s3-permission spaces=2 %} +{% data reusables.actions.enterprise-common-prereqs %} - * **AWS Service URL** (URL del servicio AWS): dirección URL del servicio MinIO. Por ejemplo, `https://my-minio.example:9000`. - * **AWS S3 Bucket** (Cubo de AWS S3): nombre del cubo de S3. - * **AWS S3 Access Key** (Clave de acceso de AWS S3) y **AWS S3 Secret Key** (Clave de secreto de AWS S3): se usan `MINIO_ACCESS_KEY` y `MINIO_SECRET_KEY` para la instancia de MinIO. +## Enabling {% data variables.product.prodname_actions %} with MinIO storage - ![Botón radial para seleccionar el almacenamiento de Amazon S3 y los campos para la configuración de MinIO](/assets/images/enterprise/management-console/actions-minio-s3-storage.png) -1. En "Artifact & Log Storage" (Almacenamiento de artefactos y registros), seleccione **Force path style** (Forzar estilo de ruta de acceso). +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.management-console %} +{% data reusables.enterprise_management_console.actions %} +{% data reusables.actions.enterprise-enable-checkbox %} +1. Under "Artifact & Log Storage", select **Amazon S3**, and enter your storage bucket's details: - ![Casilla Forzar estilo de ruta de acceso](/assets/images/enterprise/management-console/actions-minio-force-path-style.png) {% data reusables.enterprise_management_console.test-storage-button %} {% data reusables.enterprise_management_console.save-settings %} + * **AWS Service URL**: The URL to your MinIO service. For example, `https://my-minio.example:9000`. + * **AWS S3 Bucket**: The name of your S3 bucket. + * **AWS S3 Access Key** and **AWS S3 Secret Key**: The `MINIO_ACCESS_KEY` and `MINIO_SECRET_KEY` used for your MinIO instance. + + ![Radio button for selecting Amazon S3 Storage and fields for MinIO configuration](/assets/images/enterprise/management-console/actions-minio-s3-storage.png) +1. Under "Artifact & Log Storage", select **Force path style**. + + ![Checkbox to Force path style](/assets/images/enterprise/management-console/actions-minio-force-path-style.png) +{% data reusables.enterprise_management_console.test-storage-button %} +{% data reusables.enterprise_management_console.save-settings %} {% data reusables.actions.enterprise-postinstall-nextsteps %} diff --git a/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md b/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md index 6d81bf03fffc..19abc93b8487 100644 --- a/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md +++ b/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md @@ -122,7 +122,9 @@ Optionally, you can limit resource consumption on {% data variables.location.pro To enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}, you must have access to external blob storage. -{% data variables.product.prodname_actions %} uses blob storage to store data generated by workflow runs, such as workflow logs{% ifversion actions-caching %}, caches,{% endif %} and user-uploaded build artifacts. The amount of storage required depends on your usage of {% data variables.product.prodname_actions %}. Only a single external storage configuration is supported, and you can't use multiple storage providers at the same time. +{% data reusables.actions.enterprise-storage-contents %} The amount of storage required depends on your usage of {% data variables.product.prodname_actions %}. Only a single external storage configuration is supported, and you can't use multiple storage providers at the same time. + +All other {% data variables.product.prodname_actions %} data, such as the workflow files in a repository's file structure, are stored on the data storage volume for {% data variables.location.product_location %}. {% data variables.product.prodname_actions %} supports these storage providers: diff --git a/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md b/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md index af1cdb397c9e..f1b915cc36b8 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md +++ b/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md @@ -1,7 +1,7 @@ --- -title: 'Acerca de {% data variables.product.prodname_emus %}' +title: About {% data variables.product.prodname_emus %} shortTitle: About managed users -intro: 'Puedes administrar centralmente la identidad y el acceso para los miembros de tu empresa en {% data variables.product.prodname_dotcom %} desde tu proveedor de identidad.' +intro: 'You can centrally manage identity and access for your enterprise members on {% data variables.product.prodname_dotcom %} from your identity provider.' redirect_from: - /early-access/github/articles/get-started-with-managed-users-for-your-enterprise - /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users @@ -17,53 +17,48 @@ topics: - Enterprise - SSO allowTitleToDifferFromFilename: true -ms.openlocfilehash: 72d8263029317783e60d8f81f45edc3dbb8b1c8b -ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/22/2022 -ms.locfileid: '148180017' --- -## Acerca de {% data variables.product.prodname_emus %} -Con {% data variables.product.prodname_emus %}, puedes controlar las cuentas de usuario de los miembros de tu empresa a través de tu proveedor de identidad (IdP). Los usuarios que se asignen a la aplicación de {% data variables.product.prodname_emu_idp_application %} en tu IdP se aprovisionarán como cuentas de usuario nuevas en {% data variables.product.prodname_dotcom %} y se agregarán a tu empresa. Tú controlas los nombres de usuario, los datos de perfil, la pertenencia del equipo y el acceso de las cuentas de usuario al repositorio desde tu IdP. +## About {% data variables.product.prodname_emus %} -En tu IdP, puedes dar a cada {% data variables.enterprise.prodname_managed_user %} el rol de usuario, propietario de la empresa o gerente de facturación. {% data variables.enterprise.prodname_managed_users_caps %} puede ser propietario de organizaciones dentro de tu empresa y puede agregar a otros {% data variables.enterprise.prodname_managed_users %} a las organizaciones y equipos dentro de ella. Para obtener más información, vea "[Roles en una empresa](/github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise/roles-in-an-enterprise)" y "[Acerca de las organizaciones](/organizations/collaborating-with-groups-in-organizations/about-organizations)". +With {% data variables.product.prodname_emus %}, you can control the user accounts of your enterprise members through your identity provider (IdP). Users assigned to the {% data variables.product.prodname_emu_idp_application %} application in your IdP are provisioned as new user accounts on {% data variables.product.prodname_dotcom %} and added to your enterprise. You control usernames, profile data, team membership, and repository access for the user accounts from your IdP. + +In your IdP, you can give each {% data variables.enterprise.prodname_managed_user %} the role of user, enterprise owner, or billing manager. {% data variables.enterprise.prodname_managed_users_caps %} can own organizations within your enterprise and can add other {% data variables.enterprise.prodname_managed_users %} to the organizations and teams within. For more information, see "[Roles in an enterprise](/github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise/roles-in-an-enterprise)" and "[About organizations](/organizations/collaborating-with-groups-in-organizations/about-organizations)." {% ifversion oidc-for-emu %} -{% data reusables.enterprise-accounts.emu-cap-validates %} Para obtener más información, consulta "[Acerca de la compatibilidad con la directiva de acceso condicional del IdP](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy)". +{% data reusables.enterprise-accounts.emu-cap-validates %} For more information, see "[About support for your IdP's Conditional Access Policy](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy)." {% endif %} -Puedes conceder acceso a los {% data variables.enterprise.prodname_managed_users %} a repositorios de la empresa, así como la capacidad de contribuir en ellos, pero los {% data variables.enterprise.prodname_managed_users %} no pueden crear contenido público ni colaborar con otros usuarios, organizaciones y empresas del resto de {% data variables.product.prodname_dotcom %}. Para obtener más información, consulta "[Habilidades y restricciones de los {% data variables.enterprise.prodname_managed_users %}](#abilities-and-restrictions-of-enterprise-managed-users)". +You can grant {% data variables.enterprise.prodname_managed_users %} access to and the ability to contribute to repositories within your enterprise, but {% data variables.enterprise.prodname_managed_users %} cannot create public content or collaborate with other users, organizations, and enterprises on the rest of {% data variables.product.prodname_dotcom %}. For more information, see "[Abilities and restrictions of {% data variables.enterprise.prodname_managed_users %}](#abilities-and-restrictions-of-enterprise-managed-users)." -El nombre de usuario de los {% data variables.enterprise.prodname_managed_users %} de tu empresa y su información de perfil, como los nombres y direcciones de correo electrónico que se muestran, se configuran mediante tu IdP y no pueden cambiarlos los propios usuarios. Para más información, vea "[Nombres de usuario e información de perfil](#usernames-and-profile-information)". +The usernames of your enterprise's {% data variables.enterprise.prodname_managed_users %} and their profile information, such as display names and email addresses, are set by through your IdP and cannot be changed by the users themselves. For more information, see "[Usernames and profile information](#usernames-and-profile-information)." -Los propietarios de las empresas pueden auditar todas las acciones de los {% data variables.enterprise.prodname_managed_users %} en {% data variables.product.prodname_dotcom %}. Para obtener más información, consulta "[Eventos del registro de auditoría para la empresa](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise#about-audit-log-events-for-your-enterprise)". +Enterprise owners can audit all of the {% data variables.enterprise.prodname_managed_users %}' actions on {% data variables.product.prodname_dotcom %}. For more information, see "[Audit log events for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise#about-audit-log-events-for-your-enterprise)." -Para utilizar los {% data variables.product.prodname_emus %}, necesitas un tipo separado de cuenta empresarial con {% data variables.product.prodname_emus %} habilitados. Para obtener más información sobre cómo crear esta cuenta, consulte "[Acerca de las empresas con usuarios administrados](#about-enterprises-with-managed-users)". +To use {% data variables.product.prodname_emus %}, you need a separate type of enterprise account with {% data variables.product.prodname_emus %} enabled. For more information about creating this account, see "[About enterprises with managed users](#about-enterprises-with-managed-users)." {% note %} -**Nota**: Hay varias opciones para la administración de identidades y acceso con {% data variables.product.prodname_ghe_cloud %}, y la solución de {% data variables.product.prodname_emus %} no es la mejor para todos los clientes. Para obtener más información que te ayude a decidir si la opción de {% data variables.product.prodname_emus %} es adecuada para tu empresa, consulta "[Acerca de la autenticación de la empresa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#identifying-the-best-authentication-method-for-your-enterprise)". +**Note:** There are multiple options for identity and access management with {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_emus %} is not the best solution for every customer. For more information about whether {% data variables.product.prodname_emus %} is right for your enterprise, see "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#identifying-the-best-authentication-method-for-your-enterprise)." {% endnote %} -## Acerca de la administración de la pertenencia a una organización +## About organization membership management -Las pertenencias a una organización se pueden administrar manualmente o bien las puedes actualizar automáticamente mediante grupos de IdP. Para administrar las pertenencias a la organización mediante el IdP, los miembros deben agregarse a un grupo de IdP y este grupo debe estar conectado a un equipo en la organización. Para obtener más información sobre la administración automática de la organización y las pertenencias a equipos, consulta "[Administración de las pertenencias a equipos con grupos de proveedores de identidades](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/managing-team-memberships-with-identity-provider-groups)". +Organization memberships can be managed manually, or you can update memberships automatically using IdP groups. To manage organization memberships through your IdP, the members must be added to an IdP group, and the IdP group must be connected to a team within the organization. For more information about managing organization and team memberships automatically, see "[Managing team memberships with identity provider groups](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/managing-team-memberships-with-identity-provider-groups)." -La forma en que se agrega un miembro a una organización propiedad de tu empresa (mediante grupos de IdP o manualmente) determina cómo se deben quitar de una organización. +The way a member is added to an organization owned by your enterprise (through IdP groups or manually) determines how they must be removed from an organization. -- Si un miembro se agregó a una organización manualmente, debes quitarlo manualmente. La anulación de la asignación de la aplicación de {% data variables.product.prodname_emu_idp_application %} en tu IdP suspenderá al usuario pero no lo eliminará de la organización. -- Si un usuario se convirtió en miembro de una organización porque se agregó a grupos de IdP asignados a uno o varios equipos de la organización, quitarlo de _todos_ los grupos de IdP asignados asociados a la organización hará que se quite de la organización. +- If a member was added to an organization manually, you must remove them manually. Unassigning them from the {% data variables.product.prodname_emu_idp_application %} application on your IdP will suspend the user but not remove them from the organization. +- If a user became a member of an organization because they were added to IdP groups mapped to one or more teams in the organization, removing them from _all_ of the mapped IdP groups associated with the organization will remove them from the organization. -Para descubrir cómo se agregó un miembro a una organización, puedes filtrar la lista de miembros por tipo. Para más información, vea "[Visualización de personas en la empresa](/admin/user-management/managing-users-in-your-enterprise/viewing-people-in-your-enterprise#filtering-by-member-type-in-an-enterprise-with-managed-users)". +To discover how a member was added to an organization, you can filter the member list by type. For more information, see "[Viewing people in your enterprise](/admin/user-management/managing-users-in-your-enterprise/viewing-people-in-your-enterprise#filtering-by-member-type-in-an-enterprise-with-managed-users)." -## Soporte del proveedor de identidad +## Identity provider support -{% data variables.product.prodname_emus %} admite los siguientes IdP{% ifversion oidc-for-emu %} y métodos de autenticación: +{% data variables.product.prodname_emus %} supports the following IdPs{% ifversion oidc-for-emu %} and authentication methods: | | SAML | OIDC | |----------------------------------|-----------------------------------------------|-----------------------------------------------| @@ -75,36 +70,35 @@ Para descubrir cómo se agregó un miembro a una organización, puedes filtrar l {% endif %} -## Habilidades y restricciones de los {% data variables.enterprise.prodname_managed_users %} - -Los {% data variables.enterprise.prodname_managed_users_caps %} solo pueden colaborar en los repositorios privados e internos en su empresa y con los repositorios que pertenecen a su cuenta de usuario. Los {% data variables.enterprise.prodname_managed_users_caps %} tienen acceso de solo lectura al resto de la comunidad de {% data variables.product.prodname_dotcom %}. Estas restricciones de visibilidad y acceso para los usuarios, así como el contenido, aplican a todas las solicitudes, incluyendo a las de la API. - -* No se puede invitar a {% data variables.enterprise.prodname_managed_users_caps %} para que se unan a organizaciones o repositorios de fuera de la empresa, ni se puede invitar a {% data variables.enterprise.prodname_managed_users %} a otras empresas. -* Los colaboradores externos no son compatibles con los {% data variables.product.prodname_emus %}. -* Los {% data variables.enterprise.prodname_managed_users_caps %} no pueden crear incidencias ni solicitudes de incorporación de cambios, comentar o agregar reacciones, ni marcar como favoritos u observar o bifurcar repositorios fuera de la empresa. -* Los {% data variables.enterprise.prodname_managed_users_caps %} pueden ver todos los repositorios públicos en {% data variables.product.prodname_dotcom_the_website %} pero no pueden insertar código a los repositorios fuera de la empresa. -* Solo otros miembros de la empresa pueden ver a los {% data variables.enterprise.prodname_managed_users_caps %} y el contenido que estos crean. -* Los {% data variables.enterprise.prodname_managed_users_caps %} no pueden seguir a usuarios que estén fuera de la empresa. -* Los {% data variables.enterprise.prodname_managed_users_caps %} no pueden crear gists o comentar en ellos. -* Los {% data variables.enterprise.prodname_managed_users_caps %} no pueden crear flujos de trabajo de inicio para {% data variables.product.prodname_actions %}. -* Los {% data variables.enterprise.prodname_managed_users_caps %} no pueden instalar {% data variables.product.prodname_github_apps %} en sus cuentas de usuario. -* Otros usuarios de {% data variables.product.prodname_dotcom %} no pueden ver, mencionar o invitar a {% data variables.enterprise.prodname_managed_user %} para colaborar. -* Puedes elegir si los {% data variables.enterprise.prodname_managed_users %} pueden crear repositorios propiedad de sus cuentas de usuario. Para más información, vea "[Aplicación de directivas de administración de repositorios en la empresa](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-repository-creation)". -* Si permites que {% data variables.enterprise.prodname_managed_users %} creen repositorios propiedad de sus cuentas de usuario, solo pueden poseer repositorios privados y únicamente pueden invitar a otros miembros de la empresa a colaborar en los repositorios propiedad del usuario. +## Abilities and restrictions of {% data variables.enterprise.prodname_managed_users %} + +{% data variables.enterprise.prodname_managed_users_caps %} can only contribute to private and internal repositories within their enterprise and private repositories owned by their user account. {% data variables.enterprise.prodname_managed_users_caps %} have read-only access to the wider {% data variables.product.prodname_dotcom %} community. These visibility and access restrictions for users and content apply to all requests, including API requests. + +* {% data variables.enterprise.prodname_managed_users_caps %} cannot be invited to organizations or repositories outside of the enterprise, nor can the {% data variables.enterprise.prodname_managed_users %} be invited to other enterprises. +* Outside collaborators are not supported by {% data variables.product.prodname_emus %}. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot create issues or pull requests in, comment or add reactions to, nor star, watch, or fork repositories outside of the enterprise. +* {% data variables.enterprise.prodname_managed_users_caps %} can view all public repositories on {% data variables.product.prodname_dotcom_the_website %}, but cannot push code to repositories outside of the enterprise. +* {% data variables.enterprise.prodname_managed_users_caps %} and the content they create is only visible to other members of the enterprise. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot follow users outside of the enterprise. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot create gists or comment on gists. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot create starter workflows for {% data variables.product.prodname_actions %}. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot install {% data variables.product.prodname_github_apps %} on their user accounts. +* Other {% data variables.product.prodname_dotcom %} users cannot see, mention, or invite a {% data variables.enterprise.prodname_managed_user %} to collaborate. +* You can choose whether {% data variables.enterprise.prodname_managed_users %} are able to create repositories owned by their user accounts. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-repository-creation)." +* If you allow {% data variables.enterprise.prodname_managed_users %} to create repositories owned by their user accounts, they can only own private repositories and can only invite other enterprise members to collaborate on their user-owned repositories. * {% data reusables.enterprise-accounts.emu-forks %} -* Solo se pueden crear repositorios internos y privados en las organizaciones que pertenezcan a una {% data variables.enterprise.prodname_emu_enterprise %}, en función de la configuración de visibilidad del repositorio o la empresa. -* Los {% data variables.enterprise.prodname_managed_users_caps %} están limitados en su uso de {% data variables.product.prodname_pages %}. Para obtener más información, consulta [Acerca de {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages#limitations-for-enterprise-managed-users). -* {% data reusables.copilot.emus-cannot-use-copilot %} +* Only private and internal repositories can be created in organizations owned by an {% data variables.enterprise.prodname_emu_enterprise %}, depending on organization and enterprise repository visibility settings. +* {% data variables.enterprise.prodname_managed_users_caps %} are limited in their use of {% data variables.product.prodname_pages %}. For more information, see "[About {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages#limitations-for-enterprise-managed-users)." -## Introducción a {% data variables.product.prodname_emus %} +## Getting started with {% data variables.product.prodname_emus %} -Para que los desarrolladores puedan usar la {% data variables.product.prodname_ghe_cloud %} con {% data variables.product.prodname_emus %}, debes llevar a cabo una serie de pasos de configuración. +Before your developers can use {% data variables.product.prodname_ghe_cloud %} with {% data variables.product.prodname_emus %}, you must follow a series of configuration steps. -1. Para utilizar los {% data variables.product.prodname_emus %}, necesitas un tipo separado de cuenta empresarial con {% data variables.product.prodname_emus %} habilitados. Para probar {% data variables.product.prodname_emus %} o para analizar las opciones para migrar desde su empresa existente, póngase en contacto con el [equipo de ventas de {% data variables.product.prodname_dotcom %}](https://enterprise.github.com/contact). +1. To use {% data variables.product.prodname_emus %}, you need a separate type of enterprise account with {% data variables.product.prodname_emus %} enabled. To try out {% data variables.product.prodname_emus %} or to discuss options for migrating from your existing enterprise, please contact [{% data variables.product.prodname_dotcom %}'s Sales team](https://enterprise.github.com/contact). - La persona de contacto en el equipo de ventas de GitHub trabajará contigo para crear tu {% data variables.enterprise.prodname_emu_enterprise %} nueva. Necesitarás proporcionar la dirección de correo electrónico del usuario que configurará tu empresa y un código corto que se utilizará como el sufijo de los nombres de usuario de los miembros. {% data reusables.enterprise-accounts.emu-shortcode %} Para más información, vea "[Nombres de usuario e información de perfil](#usernames-and-profile-information)". + Your contact on the GitHub Sales team will work with you to create your new {% data variables.enterprise.prodname_emu_enterprise %}. You'll need to provide the email address for the user who will set up your enterprise and a short code that will be used as the suffix for your enterprise members' usernames. {% data reusables.enterprise-accounts.emu-shortcode %} For more information, see "[Usernames and profile information](#usernames-and-profile-information)." -2. Después de crear tu empresa, recibirás un mensaje de correo electrónico de {% data variables.product.prodname_dotcom %}, el cual te invitará a elegir una contraseña para tu usuario de configuración de la empresa, quien será el primer propietario de esta. Utiliza una ventana de búsqueda privada o en modo incógnito al configurar la contraseña. El usuario de configuración solo se usa para configurar el inicio de sesión único y la integración de aprovisionamiento de SCIM para la empresa. Ya no tendrá acceso para administrar la cuenta empresarial una vez que se habilite correctamente el inicio de sesión único. El nombre de usuario del usuario de configuración es el código corto de la empresa con el sufijo `_admin`. +2. After we create your enterprise, you will receive an email from {% data variables.product.prodname_dotcom %} inviting you to choose a password for your enterprise's setup user, which will be the first owner in the enterprise. Use an incognito or private browsing window when setting the password. The setup user is only used to configure single sign-on and SCIM provisioning integration for the enterprise. It will no longer have access to administer the enterprise account once SSO is successfully enabled. The setup user's username is your enterprise's shortcode suffixed with `_admin`. {% note %} @@ -112,53 +106,54 @@ Para que los desarrolladores puedan usar la {% data variables.product.prodname_g {% endnote %} -3. Después de iniciar sesión como usuario de configuración, se recomienda habilitar la autenticación en dos fases. Para obtener más información, vea "[Configuración de autenticación en dos fases](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication)". +3. After you log in as the setup user, we recommend enabling two-factor authentication. For more information, see "[Configuring two-factor authentication](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication)." -1. Para empezar, configura {% ifversion oidc-for-emu %}cómo se autenticarán los miembros. Si usas Azure Active Directory como proveedor de identidades, puedes elegir entre OpenID Connect (OIDC) y el Lenguaje de marcado de aserción de seguridad (SAML). Se recomienda OIDC, que incluye compatibilidad con directivas de acceso condicional (CAP). Si necesitas varias empresas con {% data variables.enterprise.prodname_managed_users %} aprovisionados desde un inquilino, debes usar SAML para cada empresa después de la primera. Si usas Okta como proveedor de identidades, puedes usar SAML para autenticar a los miembros. {% else %}SSO de SAML para tu empresa. Para obtener más información, consulta "[Configuración del inicio de sesión único de SAML para Usuarios Administrados de Enterprise](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)".{% endif %} +1. To get started, configure {% ifversion oidc-for-emu %}how your members will authenticate. If you are using Azure Active Directory as your identity provider, you can choose between OpenID Connect (OIDC) and Security Assertion Markup Language (SAML). We recommend OIDC, which includes support for Conditional Access Policies (CAP). If you require multiple enterprises with {% data variables.enterprise.prodname_managed_users %} provisioned from one tenant, you must use SAML for each enterprise after the first. If you are using Okta as your identity provider, you can use SAML to authenticate your members.{% else %}SAML SSO for your enterprise. For more information, see "[Configuring SAML single sign-on for Enterprise Managed Users](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)."{% endif %} {% ifversion oidc-for-emu %} - Para empezar, lea la guía del método de autenticación elegido. + To get started, read the guide for your chosen authentication method. - - "[Configuración de OIDC para Usuarios Administrados de Enterprise](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users)". - - "[Configuración del inicio de sesión único de SAML para Usuarios Administrados de Enterprise](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)". + - "[Configuring OIDC for Enterprise Managed Users](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users)." + - "[Configuring SAML single sign-on for Enterprise Managed Users](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)." {% endif %} -4. Una vez que hayas configurado el inicio de sesión único, puedes configurar el aprovisionamiento de SCIM. SCIM es cómo creará el proveedor de identidades {% data variables.enterprise.prodname_managed_users %} en los datos {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información sobre cómo configurar el aprovisionamiento de SCIM, consulta "[Configuración del aprovisionamiento de SCIM para Usuarios Administrados de Enterprise](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-scim-provisioning-for-enterprise-managed-users)". +4. Once you have configured SSO, you can configure SCIM provisioning. SCIM is how your identity provider will create {% data variables.enterprise.prodname_managed_users %} on {% data variables.product.prodname_dotcom_the_website %}. For more information on configuring SCIM provisioning, see "[Configuring SCIM provisioning for enterprise managed users](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-scim-provisioning-for-enterprise-managed-users)." -5. Una vez configurada la autenticación y el aprovisionamiento, puede empezar a administrar la pertenencia a la organización para los datos {% data variables.enterprise.prodname_managed_users %} mediante la sincronización de grupos de IdP con equipos. Para más información sobre cómo administrar equipos, vea "[Administración de pertenencias a equipos con grupos de proveedores de identidades](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/managing-team-memberships-with-identity-provider-groups)". +5. Once authentication and provisioning are configured, you can start managing organization membership for your {% data variables.enterprise.prodname_managed_users %} by synchronizing IdP groups with teams. For more information, see "[Managing team memberships with identity provider groups](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/managing-team-memberships-with-identity-provider-groups)." -Si los miembros de tu empresa deben usar una estación de trabajo para contribuir a los repositorios en {% data variables.location.product_location %} tanto de un {% data variables.enterprise.prodname_managed_user %} como de una cuenta personal, puedes proporcionar compatibilidad. Para obtener más información, consulta "[Compatibilidad con desarrolladores con varias cuentas de usuario en {% data variables.product.prodname_dotcom_the_website %}](#supporting-developers-with-multiple-user-accounts-on-githubcom)". +If members of your enterprise must use one workstation to contribute to repositories on {% data variables.location.product_location %} from both a {% data variables.enterprise.prodname_managed_user %} and a personal account, you can provide support. For more information, see "[Supporting developers with multiple user accounts on {% data variables.product.prodname_dotcom_the_website %}](#supporting-developers-with-multiple-user-accounts-on-githubcom)." -## Autenticación como {% data variables.enterprise.prodname_managed_user %} +## Authenticating as a {% data variables.enterprise.prodname_managed_user %} -Los {% data variables.enterprise.prodname_managed_users_caps %} se deben autenticar mediante su proveedor de identidad. Para autenticarse, un {% data variables.enterprise.prodname_managed_user %} puede visitar su portal de aplicación IdP o utilizar una página de inicio de sesión en el {% data variables.product.prodname_dotcom_the_website %}. +{% data variables.enterprise.prodname_managed_users_caps %} must authenticate through their identity provider. To authenticate, a {% data variables.enterprise.prodname_managed_user %} can visit their IdP application portal or use the login page on {% data variables.product.prodname_dotcom_the_website %}. -De manera predeterminada, cuando un usuario no autenticado intenta acceder a una empresa que usa {% data variables.product.prodname_emus %}, {% data variables.product.company_short %} muestra un error 404. Opcionalmente, un propietario de la empresa puede habilitar redirecciones automáticas al inicio de sesión único (SSO) en lugar de al error 404. Para más información, vea "[Aplicación de directivas de configuración de seguridad en la empresa](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-sso-for-unauthenticated-users)". +By default, when an unauthenticated user attempts to access an enterprise that uses {% data variables.product.prodname_emus %}, {% data variables.product.company_short %} displays a 404 error. An enterprise owner can optionally enable automatic redirects to single sign-on (SSO) instead of the 404. For more information, see "[Enforcing policies for security settings in your enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-sso-for-unauthenticated-users)." -{% data reusables.enterprise-accounts.about-recovery-codes %} Para más información, vea "[Administración de códigos de recuperación para la empresa](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise)". +{% data reusables.enterprise-accounts.about-recovery-codes %} For more information, see "[Managing recovery codes for your enterprise](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise)." -### Autenticarse como un {% data variables.enterprise.prodname_managed_user %} mediante el {% data variables.product.prodname_dotcom_the_website %} +### Authenticating as a {% data variables.enterprise.prodname_managed_user %} via {% data variables.product.prodname_dotcom_the_website %} -1. Vaya a [https://github.com/login](https://github.com/login). -1. En la caja de texto de "Nombre de usuario o dirección de correo electrónico", ingresa tu nombre de usuario incluyendo el guion bajo y código corto. - ![Captura de pantalla que muestra el formulario de inicio de sesión](/assets/images/help/enterprises/emu-login-username.png). Si el formulario reconoce el nombre de usuario, se actualizará. No necesitas ingresar tu contraseña en este formato. -1. Para continuar con el proveedor de identidades, haga clic en **Sign in with your identity provider** (Iniciar sesión con el proveedor de identidades). - ![Captura de pantalla que muestra el botón "Sign in with your identity provider" (Iniciar sesión con el proveedor de identidades)](/assets/images/help/enterprises/emu-login-submit.png) +1. Navigate to [https://github.com/login](https://github.com/login). +1. In the "Username or email address" text box, enter your username including the underscore and short code. + ![Screenshot showing login form](/assets/images/help/enterprises/emu-login-username.png) + When the form recognizes your username, the form will update. You do not need to enter your password on this form. +1. To continue to your identity provider, click **Sign in with your identity provider**. + ![Screenshot showing "Sign in with your identity provider" button](/assets/images/help/enterprises/emu-login-submit.png) -## Nombres de usuario e información de perfil +## Usernames and profile information -{% data variables.product.product_name %} crea automáticamente un nombre de usuario para cada persona mediante la normalización de un identificador proporcionado por el IdP. Para más información, consulta "[Consideraciones sobre el nombre de usuario para la autenticación externa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)". +{% data variables.product.product_name %} automatically creates a username for each person by normalizing an identifier provided by your IdP. For more information, see "[Username considerations for external authentication](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)." -Puede producirse un conflicto al aprovisionar usuarios si las partes únicas del identificador proporcionado por el IdP se quitan durante la normalización. Si no puedes aprovisionar un usuario debido a un conflicto con el nombre de usuario, debes modificar el nombre de usuario proporcionado por el IdP. Para obtener más información, consulta "[Resolución de problemas de nombre de usuario](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication#resolving-username-problems)". +A conflict may occur when provisioning users if the unique parts of the identifier provided by your IdP are removed during normalization. If you're unable to provision a user due to a username conflict, you should modify the username provided by your IdP. For more information, see "[Resolving username problems](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication#resolving-username-problems)." {% data reusables.enterprise-accounts.emu-only-emails-within-the-enterprise-can-conflict %} -El nombre de perfil y dirección de correo electrónico de un {% data variables.enterprise.prodname_managed_user %} también lo proporciona el IdP. Los {% data variables.enterprise.prodname_managed_users_caps %} no pueden cambiar su nombre de perfil ni la dirección de correo electrónico en {% data variables.product.prodname_dotcom %}, y el IdP solo puede proporcionar una dirección de correo electrónico. +The profile name and email address of a {% data variables.enterprise.prodname_managed_user %} is also provided by the IdP. {% data variables.enterprise.prodname_managed_users_caps %} cannot change their profile name or email address on {% data variables.product.prodname_dotcom %}, and the IdP can only provide a single email address. -## Compatibilidad con desarrolladores con varias cuentas de usuario en {% data variables.location.product_location %} +## Supporting developers with multiple user accounts on {% data variables.location.product_location %} -Es posible que personas del equipo necesiten contribuir a los recursos de {% data variables.location.product_location %} que están fuera de {% data variables.enterprise.prodname_emu_enterprise %}. Por ejemplo, puede que quieras mantener una empresa independiente para los proyectos de código abierto de la empresa. Dado que un {% data variables.enterprise.prodname_managed_user %} no puede contribuir a los recursos públicos, los usuarios deberán mantener una cuenta personal independiente para este trabajo. +People on your team may need to contribute to resources on {% data variables.location.product_location %} that are outside of your {% data variables.enterprise.prodname_emu_enterprise %}. For example, you may wish to maintain a separate enterprise for your company's open source projects. Because a {% data variables.enterprise.prodname_managed_user %} cannot contribute to public resources, users will need to maintain a separate, personal account for this work. -Las personas que deben contribuir desde dos cuentas de usuario en {% data variables.location.product_location %} con una estación de trabajo pueden configurar Git para simplificar el proceso. Para obtener más información, consulta "[Administración de varias cuentas](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts)". +People who must contribute from two user accounts on {% data variables.location.product_location %} using one workstation can configure Git to simplify the process. For more information, see "[Managing multiple accounts](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts)." diff --git a/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md b/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md index c4c97707e7b3..2705b6bb9b59 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md +++ b/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md @@ -1,7 +1,7 @@ --- -title: Acerca de SAML para IAM empresarial +title: About SAML for enterprise IAM shortTitle: About SAML for IAM -intro: 'Puedes utilizar el inicio de sesión único (SSO) de SAML {% ifversion ghae %}y el Sistema para la Administración de Identidad Entre Dominios (SCIM) {% endif %}para administrar el acceso de forma centralizada {% ifversion ghec %}a las organizaciones que pertenecen a tu empresa en {% data variables.product.prodname_dotcom_the_website %}{% elsif ghes %}a {% data variables.location.product_location %}{% elsif ghae %}a {% data variables.location.product_location %}{% endif %}.' +intro: 'You can use SAML single sign-on (SSO) {% ifversion ghae %}and System for Cross-domain Identity Management (SCIM) {% endif %}to centrally manage access {% ifversion ghec %}to organizations owned by your enterprise on {% data variables.product.prodname_dotcom_the_website %}{% elsif ghes %}to {% data variables.location.product_location %}{% elsif ghae %}to {% data variables.location.product_location %}{% endif %}.' versions: ghec: '*' ghes: '*' @@ -22,75 +22,84 @@ redirect_from: - /admin/authentication/managing-identity-and-access-for-your-enterprise/about-identity-and-access-management-for-your-enterprise - /admin/identity-and-access-management/managing-iam-for-your-enterprise/about-identity-and-access-management-for-your-enterprise - /admin/identity-and-access-management/using-saml-for-enterprise-iam/about-identity-and-access-management-for-your-enterprise -ms.openlocfilehash: d719ef81948cef75018b0976fc97ef45c267469f -ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/22/2022 -ms.locfileid: '148180033' --- -## Acerca del SSO de SAML para {% ifversion ghec or ghae %}tu empresa en {% endif %}{% ifversion ghec or ghes %}{% data variables.location.product_location %}{% elsif ghae %}{% data variables.product.product_name %}{% endif %} + +## About SAML SSO for {% ifversion ghec or ghae %}your enterprise on {% endif %}{% ifversion ghec or ghes %}{% data variables.location.product_location %}{% elsif ghae %}{% data variables.product.product_name %}{% endif %} {% ifversion ghec %} -Si los miembros de la empresa administran sus propias cuentas de usuario en {% data variables.location.product_location %}, puedes configurar la autenticación SAML como una restricción de acceso adicional para tu empresa u organización. {% data reusables.saml.dotcom-saml-explanation %} +If your enterprise members manage their own user accounts on {% data variables.location.product_location %}, you can configure SAML authentication as an additional access restriction for your enterprise or organization. {% data reusables.saml.dotcom-saml-explanation %} {% data reusables.saml.saml-accounts %} -{% data reusables.saml.about-saml-enterprise-accounts %} Para obtener más información, consulta "[Configuración del inicio de sesión único de SAML para la empresa](/admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise)". +{% data reusables.saml.about-saml-enterprise-accounts %} For more information, see "[Configuring SAML single sign-on for your enterprise](/admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise)." -Como alternativa, puedes aprovisionar y administrar las cuentas de los miembros de tu empresa con {% data variables.product.prodname_emus %}. Para ayudarte a determinar si el inicio de sesión único de SAML o {% data variables.product.prodname_emus %} es mejor para la empresa, consulta "[Acerca de la autenticación de la empresa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#identifying-the-best-authentication-method-for-your-enterprise)". +Alternatively, you can provision and manage the accounts of your enterprise members with {% data variables.product.prodname_emus %}. To help you determine whether SAML SSO or {% data variables.product.prodname_emus %} is better for your enterprise, see "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#identifying-the-best-authentication-method-for-your-enterprise)." -{% data reusables.enterprise-accounts.about-recovery-codes %} Para más información, vea "[Administración de códigos de recuperación para la empresa](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise)". +{% data reusables.enterprise-accounts.about-recovery-codes %} For more information, see "[Managing recovery codes for your enterprise](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise)." -Después de que habilites el SSO de SAML, dependiendo del IdP que utilizas, debes poder habilitar las características de administración de acceso y de identidad adicionales. +After you enable SAML SSO, depending on the IdP you use, you may be able to enable additional identity and access management features. -Si utilizas Azure AD como tu IdP, puedes utilizar la sincronización de equipos para administrar la membresía del equipo dentro de cada organización. {% data reusables.identity-and-permissions.about-team-sync %} Para más información, vea "[Administración de la sincronización de equipos para organizaciones en la cuenta de empresa](/admin/authentication/managing-identity-and-access-for-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise)". +If you use Azure AD as your IDP, you can use team synchronization to manage team membership within each organization. {% data reusables.identity-and-permissions.about-team-sync %} {% note %} -**Nota:** No puedes usar SCIM en el nivel empresarial a menos que la empresa esté habilitada para {% data variables.product.prodname_emus %}. +**Note:** You cannot configure SCIM for your enterprise account unless your account was created to use {% data variables.product.prodname_emus %}. For more information, see "[About {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users)." {% endnote %} -{% data reusables.saml.switching-from-org-to-enterprise %} Para más información, vea "[Cambio de la configuración de SAML de una organización a una cuenta de empresa](/github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account)". +{% data reusables.saml.switching-from-org-to-enterprise %} For more information, see "[Switching your SAML configuration from an organization to an enterprise account](/github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account)." {% elsif ghes %} -El SSO de SAML permite que las personas se autentiquen y accedan a {% data variables.location.product_location %} mediante un sistema externo para la administración de identidades. +SAML SSO allows people to authenticate and access {% data variables.location.product_location %} through an external system for identity management. + +SAML is an XML-based standard for authentication and authorization. When you configure SAML for {% data variables.location.product_location %}, the external system for authentication is called an identity provider (IdP). Your instance acts as a SAML service provider (SP). For more information about the SAML standard, see [Security Assertion Markup Language](https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language) on Wikipedia. -SAML es un estándar basado en XML para la autenticación y la autorización. Cuando configuras SAML para {% data variables.location.product_location %}, el sistema de autenticación externo se denomina un "proveedor de identidad" (IdP). Tu instancia actúa como un proveedor de servicios (PS) de SAML. Para obtener más información sobre el estándar SAML, consulta [Lenguaje de marcado de aserción de seguridad](https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language) en Wikipedia. +{% elsif ghae %} -Para obtener más información sobre la configuración del inicio de sesión único de SAML en {% data variables.product.product_name %}, consulta "[Configuración del inicio de sesión único de SAML para tu empresa](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise)". +{% data reusables.saml.ae-uses-saml-sso %} {% data reusables.saml.ae-enable-saml-sso-during-bootstrapping %} -{% data reusables.saml.saml-ghes-account-revocation %} +After you configure the application for {% data variables.product.product_name %} on your identity provider (IdP), you can provision access to {% data variables.location.product_location %} by assigning users and groups to the application on your IdP. For more information about SAML SSO for {% data variables.product.product_name %}, see "[Configuring SAML single sign-on for your enterprise](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise)." + +{% endif %} + +{% ifversion ghes < 3.6 %} + +Your IdP does not communicate with {% data variables.product.product_name %} automatically when you assign or unassign the application. {% data variables.product.product_name %} creates a user account using SAML Just-in-Time (JIT) provisioning the first time someone navigates to {% data variables.product.product_name %} and signs in by authenticating through your IdP. You may need to manually notify users when you grant access to {% data variables.product.product_name %}. + +{% endif %} + +{% ifversion ghes %} {% data reusables.enterprise_user_management.external_auth_disables_2fa %} {% data reusables.enterprise_user_management.built-in-authentication %} -{% elsif ghae %} +{% endif %} + +For more information about the configuration of SAML SSO on {% data variables.product.product_name %}, see "[Configuring SAML single sign-on for your enterprise](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise)."{% ifversion ghec or ghae or scim-for-ghes %} To learn how to configure both authentication and {% ifversion ghae or ghes %}user {% endif %}provisioning for {% data variables.location.product_location %} with your specific IdP, see the articles for individual IdPs in "[Using SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam)."{% endif %} -{% data reusables.saml.ae-uses-saml-sso %}{% data reusables.saml.ae-enable-saml-sso-during-bootstrapping %} +{% ifversion ghae or scim-for-ghes %} -Después de configurar la aplicación de {% data variables.product.product_name %} en tu proveedor de identidad (IdP), puedes aprovisionar el acceso a {% data variables.location.product_location %} si asignas la aplicación a los usuarios y grupos de tu IdP. Para más información sobre el inicio de sesión único de SAML para {% data variables.product.product_name %}, vea "[Configuración del inicio de sesión único de SAML para la empresa](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise)". +## About creation of user accounts -{% data reusables.scim.after-you-configure-saml %} Para más información, vea "[Configuración del aprovisionamiento de usuarios para la empresa](/admin/authentication/configuring-user-provisioning-for-your-enterprise)". +{% data reusables.scim.after-you-configure-saml %} For more information, see "[Configuring user provisioning for your enterprise](/admin/authentication/configuring-user-provisioning-for-your-enterprise)." -Para obtener información sobre cómo configurar la autenticación y el aprovisionamiento de usuarios para {% data variables.location.product_location %} con el IdP específico, vea "[Configuración de la autenticación y el aprovisionamiento con el proveedor de identidades](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider)". +{% data reusables.saml.saml-ghes-account-revocation %} {% endif %} -## IdP compatibles +## Supported IdPs {% ifversion ghec %} -Probamos y damos compatibilidad oficial de los siguientes IdP. Para el SSO de SAML, ofrecemos soporte limitado para todos los proveedores de identidad que implementan el SAML 2.0 estándar. Para más información, vea la [wiki de SAML](https://wiki.oasis-open.org/security) en el sitio web de OASIS. +We test and officially support the following IdPs. For SAML SSO, we offer limited support for all identity providers that implement the SAML 2.0 standard. For more information, see the [SAML Wiki](https://wiki.oasis-open.org/security) on the OASIS website. -IdP | SAML | Sincronización de equipos | +IdP | SAML | Team synchronization | --- | :--: | :-------: | -Servicios de federación de Active Directory (AD FS) | {% octicon "check-circle-fill" aria-label= "The check icon" %} | | -Azure Active Directory (Azure AD) | {% octicon "check-circle-fill" aria-label="The check icon" %} | {% octicon "check-circle-fill" aria-label="The check icon" %} | +Active Directory Federation Services (AD FS) | {% octicon "check-circle-fill" aria-label= "The check icon" %} | | +Azure Active Directory (Azure AD) | {% octicon "check-circle-fill" aria-label="The check icon" %} | {% octicon "check-circle-fill" aria-label="The check icon" %} | Okta | {% octicon "check-circle-fill" aria-label="The check icon" %} | | OneLogin | {% octicon "check-circle-fill" aria-label="The check icon" %} | | PingOne | {% octicon "check-circle-fill" aria-label="The check icon" %} | | @@ -102,7 +111,7 @@ Shibboleth | {% octicon "check-circle-fill" aria-label="The check icon" %} | | {% ifversion ghes > 3.3 %} -Si tu IdP es compatible con confirmaciones cifradas, puedes configurarlas en {% data variables.product.product_name %} para incrementar la seguridad durante el proceso de autenticación. +If your IdP supports encrypted assertions, you can configure encrypted assertions on {% data variables.product.product_name %} for increased security during the authentication process. {% endif %} @@ -110,7 +119,7 @@ Si tu IdP es compatible con confirmaciones cifradas, puedes configurarlas en {% {% elsif ghae %} -Los siguientes IdP son oficialmente compatibles para su integración con {% data variables.product.prodname_ghe_managed %}. +The following IdPs are officially supported for integration with {% data variables.product.prodname_ghe_managed %}. {% data reusables.saml.okta-ae-sso-beta %} @@ -120,14 +129,18 @@ Los siguientes IdP son oficialmente compatibles para su integración con {% data {% ifversion ghae %} -## Mapear equipos de {% data variables.product.prodname_ghe_managed %} en grupos de Okta +## Mapping {% data variables.product.prodname_ghe_managed %} teams to Okta groups -Si utilizas Okta como tu IdP, puedes asignar grupos de Okta a equipos en {% data variables.product.product_name %}. Para más información, vea "[Asignación de grupos de Okta a equipos](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/mapping-okta-groups-to-teams)". +If you use Okta as your IdP, you can map your Okta groups to teams on {% data variables.product.product_name %}. For more information, see "[Mapping Okta groups to teams](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/mapping-okta-groups-to-teams)." {% endif %} -## Información adicional +## Further reading -- [Wiki de SAML](https://wiki.oasis-open.org/security) en el sitio web de OASIS -- [System for Cross-domain Identity Management: protocolo (RFC 7644)](https://tools.ietf.org/html/rfc7644) en el sitio web de IETF {%- ifversion ghae %} -- "[Restricción del tráfico de red a la empresa con una lista de direcciones IP permitidas](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)" {%- endif %} +- [SAML Wiki](https://wiki.oasis-open.org/security) on the OASIS website +{%- ifversion ghae or scim-for-ghes %} +- [System for Cross-domain Identity Management: Protocol (RFC 7644)](https://tools.ietf.org/html/rfc7644) on the IETF website +{%- endif %} +{%- ifversion ghae %} +- "[Restricting network traffic to your enterprise with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)" +{%- endif %} diff --git a/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md b/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md index 7fe38c4bb710..9cae70edd510 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md +++ b/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md @@ -1,7 +1,7 @@ --- -title: Configurar la autenticación y el aprovisionamiento para tu empresa utilizando Azure AD +title: Configuring authentication and provisioning for your enterprise using Azure AD shortTitle: Configure with Azure AD -intro: "Puedes usar un inquilino en Azure Active Directory (Azure\_AD) como proveedor de identidades (IdP) para administrar centralmente la autenticación y el aprovisionamiento de usuarios para {% data variables.location.product_location %}." +intro: 'You can use a tenant in Azure Active Directory (Azure AD) as an identity provider (IdP) to centrally manage authentication and user provisioning for {% data variables.location.product_location %}.' permissions: 'Enterprise owners can configure authentication and provisioning for an enterprise on {% data variables.product.product_name %}.' versions: ghae: '*' @@ -17,69 +17,62 @@ redirect_from: - /admin/authentication/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad - /admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad - /admin/identity-and-access-management/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad -ms.openlocfilehash: bfd93814b11066d6da2d87a2e1f0a8bd5461e93f -ms.sourcegitcommit: ced661bdffebd0f96f6f76db109fbe31983448ba -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/16/2022 -ms.locfileid: '148167064' --- -## Acerca de la autenticación y el aprovisionamiento de usuarios con Azure AD -Azure Active Directory (Azure AD) es un servicio de Microsoft que te permite administrar centralmente las cuentas de usuario y el acceso a las aplicaciones web. Para obtener más información, consulte [¿Qué Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis) en Microsoft Docs. +## About authentication and user provisioning with Azure AD -Para administrar la identidad y el acceso para {% data variables.product.product_name %}, puedes utilizar un inquilino en Azure AD como un IdP de SAML para la autenticación. También puedes configurar Azure AD de modo que aprovisione automáticamente las cuentas y acceda a las pertenencias con SCIM, lo cual te permite crear usuarios de {% data variables.product.product_name %} y administrar las pertenencias de equipo y de organización desde tu inquilino de Azure AD. +Azure Active Directory (Azure AD) is a service from Microsoft that allows you to centrally manage user accounts and access to web applications. For more information, see [What is Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis) in the Microsoft Docs. + +{% data reusables.saml.idp-saml-and-scim-explanation %} {% data reusables.scim.ghes-beta-note %} -Después de habilitar el inicio de sesión único de SAML y SCIM para {% data variables.product.product_name %} mediante Azure AD, puedes hacer lo siguiente desde tu inquilino de Azure AD. +After you enable SAML SSO and SCIM for {% data variables.product.product_name %} using Azure AD, you can accomplish the following from your Azure AD tenant. -* Asignar la aplicación de {% data variables.product.product_name %} en Azure AD a una cuenta de usuario para que cree y otorgue acceso automáticamente a una cuenta de usuario correspondiente en {% data variables.product.product_name %}. -* Desasignar la aplicación de {% data variables.product.product_name %} de una cuenta de usuario en Azure AD para desactivar la cuenta de usuario correspondiente en {% data variables.product.product_name %}. -* Asignar la aplicación de {% data variables.product.product_name %} a un grupo de IdP en Azure AD para que cree y otorgue acceso automáticamente a las cuentas de usuario en {% data variables.product.product_name %} para todos los miembros del grupo de IdP. Además, el grupo de IdP estará disponible en {% data variables.product.product_name %} para que se conecte a un equipo y a sus organizaciones primarias. -* Desasignar la aplicación de {% data variables.product.product_name %} desde un grupo de IdP para desactivar las cuentas de usuario de {% data variables.product.product_name %} de todos los usuarios de IdP que tuvieron acceso únicamente a través de este grupo de IdP y eliminar a los usuarios de la organización primaria. El grupo de IdP se desconectará de cualquier equipo en {% data variables.product.product_name %}. +* Assign the {% data variables.product.product_name %} application on Azure AD to a user account to automatically create and grant access to a corresponding user account on {% data variables.product.product_name %}. +* Unassign the {% data variables.product.product_name %} application to a user account on Azure AD to deactivate the corresponding user account on {% data variables.product.product_name %}. +* Assign the {% data variables.product.product_name %} application to an IdP group on Azure AD to automatically create and grant access to user accounts on {% data variables.product.product_name %} for all members of the IdP group. In addition, the IdP group is available on {% data variables.product.product_name %} for connection to a team and its parent organization. +* Unassign the {% data variables.product.product_name %} application from an IdP group to deactivate the {% data variables.product.product_name %} user accounts of all IdP users who had access only through that IdP group and remove the users from the parent organization. The IdP group will be disconnected from any teams on {% data variables.product.product_name %}. -Para obtener más información sobre cómo administrar la identidad y el acceso de la empresa en{% data variables.location.product_location %}, consulta "[Administración de la identidad y el acceso para la empresa](/admin/authentication/managing-identity-and-access-for-your-enterprise)". Para obtener más información sobre la sincronización de equipos con grupos de IdP, consulte "[Sincronizar un equipo con un grupo de proveedores de identidades](/organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group)". +For more information about managing identity and access for your enterprise on {% data variables.location.product_location %}, see "[Managing identity and access for your enterprise](/admin/authentication/managing-identity-and-access-for-your-enterprise)." -## Requisitos previos +## Prerequisites -- Para configurar la autenticación y el aprovisionamiento de usuarios para {% data variables.product.product_name %} utilizando Azure AD, debes tener una cuenta y un inquilino en Azure AD. Para obtener más información, consulte el [sitio web de Azure AD](https://azure.microsoft.com/free/active-directory) e [Inicio rápido: Creación de un inquilino de Azure Active Directory](https://docs.microsoft.com/azure/active-directory/develop/quickstart-create-new-tenant) en Microsoft Docs. +- To configure authentication and user provisioning for {% data variables.product.product_name %} using Azure AD, you must have an Azure AD account and tenant. For more information, see the [Azure AD website](https://azure.microsoft.com/free/active-directory) and [Quickstart: Create an Azure Active Directory tenant](https://docs.microsoft.com/azure/active-directory/develop/quickstart-create-new-tenant) in the Microsoft Docs. {%- ifversion scim-for-ghes %} -- {% data reusables.saml.ghes-you-must-configure-saml-sso %} {%- endif %} +- {% data reusables.saml.ghes-you-must-configure-saml-sso %} +{%- endif %} - {% data reusables.saml.create-a-machine-user %} -## Configurar la autenticación y el aprovisionamiento de usuarios con Azure AD - -En el inquilino de Azure AD, agrega la aplicación para {% data variables.product.product_name %} y, luego, configura el aprovisionamiento. +## Configuring authentication and user provisioning with Azure AD {% ifversion ghae %} -1. En Azure AD, agrega la {% data variables.enterprise.ae_azure_ad_app_link %} a tu inquilino y configura el inicio de sesión único. Para obtener más información, consulta [Tutorial: Integración del inicio de sesión único (SSO) de Azure Active Directory con {% data variables.product.product_name %}](https://docs.microsoft.com/azure/active-directory/saas-apps/github-ae-tutorial) en Microsoft Docs. +In your Azure AD tenant, add the application for {% data variables.product.product_name %}, then configure provisioning. + +1. In Azure AD, add the {% data variables.enterprise.ae_azure_ad_app_link %} to your tenant and configure single sign-on. For more information, see [Tutorial: Azure Active Directory single sign-on (SSO) integration with {% data variables.product.product_name %}](https://docs.microsoft.com/azure/active-directory/saas-apps/github-ae-tutorial) in the Microsoft Docs. -1. En {% data variables.product.product_name %}, especifica los detalles de tu inquilino de Azure AD. +1. In {% data variables.product.product_name %}, enter the details for your Azure AD tenant. - {% data reusables.saml.ae-enable-saml-sso-during-bootstrapping %} - - Si ya configuraste el SSO de SAML para {% data variables.location.product_location %} con otro IdP y quieres usar Azure AD en su lugar, puedes editar la configuración. Para obtener más información, consulte "[Configuración del inicio de sesión único de SAML para la empresa](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise#editing-the-saml-sso-configuration)". + - If you've already configured SAML SSO for {% data variables.location.product_location %} using another IdP and you want to use Azure AD instead, you can edit your configuration. For more information, see "[Configuring SAML single sign-on for your enterprise](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise#editing-the-saml-sso-configuration)." -1. Habilita el aprovisionamiento de usuarios en {% data variables.product.product_name %} y configura el aprovisionamiento de usurios en Azure AD. Para obtener más información, consulte "[Configuración del aprovisionamiento de usuarios para la empresa](/admin/authentication/configuring-user-provisioning-for-your-enterprise#enabling-user-provisioning-for-your-enterprise)". +1. Enable user provisioning in {% data variables.product.product_name %} and configure user provisioning in Azure AD. For more information, see "[Configuring user provisioning for your enterprise](/admin/authentication/configuring-user-provisioning-for-your-enterprise#enabling-user-provisioning-for-your-enterprise)." {% elsif scim-for-ghes %} -1. En el inquilino de Azure AD, en la barra lateral izquierda, haz clic en **Aprovisionamiento**. +1. Configure SAML SSO for {% data variables.location.product_location %}. For more information, see "[Configuring SAML single sign-on for your enterprise](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise#configuring-saml-sso)." +1. Configure user provisioning with SCIM for your instance. For more information, see "[Configuring user provisioning with SCIM for your enterprise](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise)." -1. En "URL de inquilino", escribe la dirección URL completa del punto de conexión para SCIM en {% data variables.location.product_location %}. Para obtener más información, consulta "[SCIM](/rest/enterprise-admin/scim#scim-endpoint-urls)" en la documentación de la API REST. - -1. En "Token secreto", escribe el {% data variables.product.pat_v1 %} que creaste en el paso 4 de "[Configuración del aprovisionamiento de usuarios con SCIM para la empresa](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise#enabling-user-provisioning-for-your-enterprise)". +{% endif %} -1. Para garantizar una conexión correcta desde Azure AD con {% data variables.location.product_location %}, haz clic en **Probar conexión**. +## Managing enterprise owners -1. Después de asegurarte de que la conexión es correcta, en la parte superior de la página, haz clic en **Guardar**. +The steps to make a person an enterprise owner depend on whether you only use SAML or also use SCIM. For more information about enterprise owners, see "[Roles in an enterprise](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)." -{% endif %} +If you configured provisioning, to grant the user enterprise ownership in {% data variables.product.product_name %}, assign the enterprise owner role to the user in Azure AD. -1. Asigne un propietario de empresa para los datos {% data variables.product.product_name %} en Azure AD. El proceso que debes seguir depende de si configuraste el aprovisionamiento. Para obtener más información sobre los propietarios de empresas, consulta "[Roles en una empresa](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owners)". - - Si has configurado el aprovisionamiento, para conceder la propiedad empresarial del usuario en {% data variables.product.product_name %}, asigna el rol de propietario de empresa al usuario de Azure AD. - - Si no configuraste el aprovisionamiento, para conceder la propiedad empresarial del usuario en {% data variables.product.product_name %}, incluye el atributo `administrator` con el valor de `true` en la aserción de SAML para la cuenta de usuario en el IdP. Para obtener más información sobre la inclusión del atributo `administrator` en la notificación de SAML de Azure AD, consulta: [Procedimiento: personalización de las notificaciones emitidas en el token SAML para aplicaciones empresariales](https://docs.microsoft.com/azure/active-directory/develop/active-directory-saml-claims-customization) en Microsoft Docs. +If you did not configure provisioning, to grant the user enterprise ownership in {% data variables.product.product_name %}, include the `administrator` attribute in the SAML assertion for the user account on the IdP, with the value of `true`. For more information about including the `administrator` attribute in the SAML claim from Azure AD, see [How to: customize claims issued in the SAML token for enterprise applications](https://docs.microsoft.com/azure/active-directory/develop/active-directory-saml-claims-customization) in the Microsoft Docs. diff --git a/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-okta.md b/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-okta.md index e7fc3c1cea88..57fe0921451f 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-okta.md +++ b/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-okta.md @@ -1,11 +1,10 @@ --- -title: Configurar la autenticación y aprovisionamiento para tu empresa utilizando Okta +title: Configuring authentication and provisioning for your enterprise using Okta shortTitle: Configure with Okta -intro: 'Puedes usar Okta como proveedor de identidades (IdP) para administrar centralmente la autenticación y el aprovisionamiento de usuarios para {% data variables.location.product_location %}.' +intro: 'You can use Okta as an identity provider (IdP) to centrally manage authentication and user provisioning for {% data variables.location.product_location %}.' permissions: 'Enterprise owners can configure authentication and provisioning for {% data variables.product.product_name %}.' versions: ghae: '*' - feature: scim-for-ghes redirect_from: - /admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-okta - /admin/identity-and-access-management/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-okta @@ -17,151 +16,166 @@ topics: - Identity - SSO miniTocMaxHeadingLevel: 3 -ms.openlocfilehash: 1655ca7f800b94c150455a077b867e7e08fa924b -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148107521' --- + {% data reusables.saml.okta-ae-sso-beta %} -## Acerca de la autenticación y el aprovisionamiento de usuarios con Okta +## About authentication and user provisioning with Okta + +You can use Okta as an Identity Provider (IdP) for {% data variables.product.product_name %}, which allows your Okta users to sign in to {% data variables.product.product_name %} using their Okta credentials. + +To use Okta as your IdP for {% data variables.product.product_name %}, you can add the {% data variables.product.product_name %} app to Okta, configure Okta as your IdP in {% data variables.product.product_name %}, and provision access for your Okta users and groups. -Puedes usar Okta como proveedor de identidades (IdP) para {% data variables.product.product_name %}, lo cual permite que tus usuarios de Okta inicien sesión en {% data variables.product.product_name %} con sus credenciales de Okta. +{% data reusables.saml.idp-saml-and-scim-explanation %} +- "[Mapping Okta groups to teams](/admin/identity-and-access-management/using-saml-for-enterprise-iam/mapping-okta-groups-to-teams)" -Para usar Okta como IdP para {% data variables.product.product_name %}, puedes agregar la aplicación de {% data variables.product.product_name %} a Okta, configurar Okta como IdP en {% data variables.product.product_name %} y aprovisionar el acceso para tus usuarios y grupos de Okta. +After you enable SCIM, the following provisioning features are available for any users that you assign your {% data variables.product.product_name %} application to in Okta. {% data reusables.scim.ghes-beta-note %} -Las siguientes características de aprovisionamiento están disponibles para todos los usuarios de Okta que asignes a tu aplicación de {% data variables.product.product_name %}. +The following provisioning features are available for all Okta users that you assign to your {% data variables.product.product_name %} application. -| Característica | Descripción | +| Feature | Description | | --- | --- | -| Subir Usuarios Nuevos | Cuando crees un usuario en Okta, se agregará a {% data variables.product.product_name %}. | -| Subir Desactivaciones de Usuarios | Cuando desactives a un usuario en Okta, este suspenderá al usuario en tu empresa en {% data variables.product.product_name %}. | -| Subir Actualizaciones de Perfil | Cuando actualices el perfil de un usuario en Okta, este actualizará los metadatos de la pertenencia del usuario en tu empresa en {% data variables.product.product_name %}. | -| Reactivar Usuarios | Cuando reactives a un usuario en Okta, este anulará la suspensión del usuario en tu empresa en {% data variables.product.product_name %}. | +| Push New Users | When you create a new user in Okta, the user is added to {% data variables.product.product_name %}. | +| Push User Deactivation | When you deactivate a user in Okta, it will suspend the user from your enterprise on {% data variables.product.product_name %}. | +| Push Profile Updates | When you update a user's profile in Okta, it will update the metadata for the user's membership in your enterprise on {% data variables.product.product_name %}. | +| Reactivate Users | When you reactivate a user in Okta, it will unsuspend the user in your enterprise on {% data variables.product.product_name %}. | -## Requisitos previos +For more information about managing identity and access for your enterprise on {% data variables.location.product_location %}, see "[Managing identity and access for your enterprise](/admin/authentication/managing-identity-and-access-for-your-enterprise)." -- Para configurar la autenticación y el aprovisionamiento de usuarios para {% data variables.product.product_name %} con Okta, debes tener una cuenta y un inquilino de Okta. +## Prerequisites + +- To configure authentication and user provisioning for {% data variables.product.product_name %} using Okta, you must have an Okta account and tenant. {%- ifversion scim-for-ghes %} -- {% data reusables.saml.ghes-you-must-configure-saml-sso %} {%- endif %} +- {% data reusables.saml.ghes-you-must-configure-saml-sso %} +{%- endif %} - {% data reusables.saml.create-a-machine-user %} -## Adición de la aplicación {% data variables.product.product_name %} en Okta +## Adding the {% data variables.product.product_name %} application in Okta -{% data reusables.saml.okta-ae-applications-menu %} {% data reusables.saml.okta-browse-app-catalog %} {%- ifversion ghae %} -1. En el campo de búsqueda, escriba "GitHub AE" y, después, haga clic en **GitHub AE** en los resultados. +{% data reusables.saml.okta-ae-applications-menu %} +{% data reusables.saml.okta-browse-app-catalog %} +{%- ifversion ghae %} +1. In the search field, type "GitHub AE", then click **GitHub AE** in the results. - !["Resultado de la búsqueda"](/assets/images/help/saml/okta-ae-search.png) -1. Haga clic en **Agregar**. + !["Search result"](/assets/images/help/saml/okta-ae-search.png) +1. Click **Add**. - !["Agregar aplicación GitHub AE"](/assets/images/help/saml/okta-ae-add-github-ae.png) -1. En "URL base", escribe la URL de tu empresa en {% data variables.product.product_name %}. + !["Add GitHub AE app"](/assets/images/help/saml/okta-ae-add-github-ae.png) +1. For "Base URL", type the URL of your enterprise on {% data variables.product.product_name %}. - !["Configurar la URL base"](/assets/images/help/saml/okta-ae-configure-base-url.png) -1. Haga clic en **Done**(Listo). + !["Configure Base URL"](/assets/images/help/saml/okta-ae-configure-base-url.png) +1. Click **Done**. {%- elsif scim-for-ghes %} -1. En el campo de búsqueda, escribe "GitHub Enterprise Server" y haz clic en **GitHub Enterprise Server** en los resultados. -1. Haga clic en **Agregar**. -1. En "URL base", escribe la URL de {% data variables.location.product_location %}. -1. Haga clic en **Done**(Listo). +1. In the search field, type "GitHub Enterprise Server", then click **GitHub Enterprise Server** in the results. +1. Click **Add**. +1. For "Base URL", type the URL of {% data variables.location.product_location %}. +1. Click **Done**. {% endif %} -## Habilitación del SSO de SAML para {% data variables.product.product_name %} +## Enabling SAML SSO for {% data variables.product.product_name %} -Si quieres habilitar el inicio de sesión único (SSO) para {% data variables.product.product_name %}, debes configurar {% data variables.product.product_name %} de modo que use la URL de inicio de sesión, la URL del emisor y el certificado público que proporcionó Okta. Encontrarás estos detalles en la aplicación de Okta para {% data variables.product.product_name %}. +To enable single sign-on (SSO) for {% data variables.product.product_name %}, you must configure {% data variables.product.product_name %} to use the sign-on URL, issuer URL, and public certificate provided by Okta. You can find these details in the Okta app for {% data variables.product.product_name %}. -{% data reusables.saml.okta-ae-applications-menu %} {% data reusables.saml.okta-click-on-the-app %} {% ifversion ghae %} {% data reusables.saml.okta-sign-on-tab %} {% data reusables.saml.okta-view-setup-instructions %} -1. Toma nota de los detalles de "URL de inicio de sesión", "Emisor" y "Certificado público". -1. Usa los detalles para habilitar el SSO de SAML para tu empresa en {% data variables.product.product_name %}. Para más información, vea "[Configuración del inicio de sesión único de SAML para la empresa](/admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise)". -{% elsif scim-for-ghes %} {% data reusables.saml.okta-sign-on-tab %} -1. Usa los detalles para habilitar el SSO de SAML para {% data variables.location.product_location %}. Para más información, vea "[Configuración del inicio de sesión único de SAML para la empresa](/admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise)". +{% data reusables.saml.okta-ae-applications-menu %} +{% data reusables.saml.okta-click-on-the-app %} +{% ifversion ghae %} +{% data reusables.saml.okta-sign-on-tab %} +{% data reusables.saml.okta-view-setup-instructions %} +1. Take note of the "Sign on URL", "Issuer", and "Public certificate" details. +1. Use the details to enable SAML SSO for your enterprise on {% data variables.product.product_name %}. For more information, see "[Configuring SAML single sign-on for your enterprise](/admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise)." +{% elsif scim-for-ghes %} +{% data reusables.saml.okta-sign-on-tab %} +1. Use the details to enable SAML SSO for {% data variables.location.product_location %}. For more information, see "[Configuring SAML single sign-on for your enterprise](/admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise)." {%- endif %} {% note %} -**Nota**: Para probar la configuración de SAML desde {% data variables.product.product_name %}, tu cuenta de usuario de Okta debe estar asignada a la aplicación de {% data variables.product.product_name %}. +**Note:** To test your SAML configuration from {% data variables.product.product_name %}, your Okta user account must be assigned to the {% data variables.product.product_name %} app. {% endnote %} -## Habilitar la integración con la API +## Enabling API integration -La aplicación de Okta usa la API REST para {% data variables.product.product_name %} para el aprovisionamiento de SCIM. Para habilitar y probar el acceso a la API, configura Okta con un {% data variables.product.pat_generic %} para {% data variables.product.product_name %}. +The Okta app uses the REST API for {% data variables.product.product_name %} for SCIM provisioning. You can enable and test access to the API by configuring Okta with a {% data variables.product.pat_generic %} for {% data variables.product.product_name %}. -1. En {% data variables.product.product_name %}, genera un {% data variables.product.pat_v1 %} con el ámbito `admin:enterprise`. Para obtener más información, consulta "[Creación de un {% data variables.product.pat_generic %}](/github/authenticating-to-github/keeping-your-account-and-data-secure/creating-a-personal-access-token)". -{% data reusables.saml.okta-ae-applications-menu %} {% data reusables.saml.okta-click-on-the-app %} {% data reusables.saml.okta-ae-provisioning-tab %} -1. Haga clic en **Configure API Integration** (Configurar la integración de la API). +1. In {% data variables.product.product_name %}, generate a {% data variables.product.pat_v1 %} with the `admin:enterprise` scope. For more information, see "[Creating a {% data variables.product.pat_generic %}](/github/authenticating-to-github/keeping-your-account-and-data-secure/creating-a-personal-access-token)". +{% data reusables.saml.okta-ae-applications-menu %} +{% data reusables.saml.okta-click-on-the-app %} +{% data reusables.saml.okta-ae-provisioning-tab %} +1. Click **Configure API Integration**. -1. Seleccione **Enable API integration** (Habilitar la integración con la API). +1. Select **Enable API integration**. - ![Habilitar la integración con la API](/assets/images/help/saml/okta-ae-enable-api-integration.png) + ![Enable API integration](/assets/images/help/saml/okta-ae-enable-api-integration.png) -1. En "Token de API", escribe el {% data variables.product.pat_generic %} de {% data variables.product.product_name %} que generaste anteriormente. +1. For "API Token", type the {% data variables.product.product_name %} {% data variables.product.pat_generic %} you generated previously. -1. Haga clic en **Test API Credentials** (Probar credenciales de la API). +1. Click **Test API Credentials**. {% note %} -**Nota**: Si se muestra `Error authenticating: No results for users returned`, confirma que has habilitado el inicio de sesión único para {% data variables.product.product_name %}. Para obtener más información, consulta "[Habilitación de SSO de SAML para {% data variables.product.product_name %}](#enabling-saml-sso-for-github-ae)". +**Note:** If you see `Error authenticating: No results for users returned`, confirm that you have enabled SSO for {% data variables.product.product_name %}. For more information see "[Enabling SAML SSO for {% data variables.product.product_name %}](#enabling-saml-sso-for-github-ae)." {% endnote %} -## Configurar los ajustes de aprovisionamiento de SCIM +## Configuring SCIM provisioning settings -Este procedimiento demuestra cómo configurar los ajustes del SCIM para el aprovisionamiento de Okta. Estos ajustes definen qué características se usarán cuando se aprovisionen cuentas de usuario de Okta automáticamente en {% data variables.product.product_name %}. +This procedure demonstrates how to configure the SCIM settings for Okta provisioning. These settings define which features will be used when automatically provisioning Okta user accounts to {% data variables.product.product_name %}. -{% data reusables.saml.okta-ae-applications-menu %} {% data reusables.saml.okta-click-on-the-app %} {% data reusables.saml.okta-ae-provisioning-tab %} -1. En "Settings" (Configuración), haga clic en **To App** (En la aplicación). +{% data reusables.saml.okta-ae-applications-menu %} +{% data reusables.saml.okta-click-on-the-app %} +{% data reusables.saml.okta-ae-provisioning-tab %} +1. Under "Settings", click **To App**. - ![Configuración de "En la aplicación"](/assets/images/help/saml/okta-ae-to-app-settings.png) + !["To App" settings](/assets/images/help/saml/okta-ae-to-app-settings.png) -1. A la derecha de "Provisioning to App" (Aprovisionamiento en aplicación), haga clic en **Edit** (Editar). -1. A la derecha de "Create Users" (Crear usuarios), seleccione **Enable** (Habilitar). -1. A la derecha de "Update User Attributes" (Actualizar atributos de usuario), seleccione **Enable** (Habilitar). -1. A la derecha de "Deactivate Users" (Desactivar usuarios), seleccione **Enable** (Habilitar). -1. Haga clic en **Save**(Guardar). +1. To the right of "Provisioning to App", click **Edit**. +1. To the right of "Create Users", select **Enable**. +1. To the right of "Update User Attributes", select **Enable**. +1. To the right of "Deactivate Users", select **Enable**. +1. Click **Save**. -## Permiso para que los usuarios y grupos de Okta accedan a {% data variables.product.product_name %} +## Allowing Okta users and groups to access {% data variables.product.product_name %} -Puedes aprovisionar el acceso a {% data variables.product.product_name %} para tus usuarios individuales de Okta o para grupos enteros. +You can provision access to {% data variables.product.product_name %} for your individual Okta users, or for entire groups. -### Aprovisionar el acceso para los usuarios de Okta +### Provisioning access for Okta users -Para que los usuarios de Okta puedan usar sus credenciales para iniciar sesión en {% data variables.product.product_name %}, debes asignarlos primero a la aplicación de Okta para {% data variables.product.product_name %}. +Before your Okta users can use their credentials to sign in to {% data variables.product.product_name %}, you must assign the users to the Okta app for {% data variables.product.product_name %}. -{% data reusables.saml.okta-ae-applications-menu %} {% data reusables.saml.okta-click-on-the-app %} +{% data reusables.saml.okta-ae-applications-menu %} +{% data reusables.saml.okta-click-on-the-app %} -1. Haga clic en **Asignaciones**. +1. Click **Assignments**. - ![Pestaña de tareas](/assets/images/help/saml/okta-ae-assignments-tab.png) + ![Assignments tab](/assets/images/help/saml/okta-ae-assignments-tab.png) -1. Seleccione el menú desplegable Assign (Asignar) y haga clic en **Assign to People** (Asignar a personas). +1. Select the Assign drop-down menu and click **Assign to People**. - ![Botón "Asignar a personas"](/assets/images/help/saml/okta-ae-assign-to-people.png) + !["Assign to People" button](/assets/images/help/saml/okta-ae-assign-to-people.png) -1. A la derecha de la cuenta de usuario requerida, haga clic en **Assign** (Asignar). +1. To the right of the required user account, click **Assign**. - ![Lista de usuarios](/assets/images/help/saml/okta-ae-assign-user.png) + ![List of users](/assets/images/help/saml/okta-ae-assign-user.png) -1. A la derecha de "Role" (Rol), haga clic en un rol para el usuario y luego en **Save and go back** (Guardar y volver). +1. To the right of "Role", click a role for the user, then click **Save and go back**. - ![Selección de roles](/assets/images/help/saml/okta-ae-assign-role.png) + ![Role selection](/assets/images/help/saml/okta-ae-assign-role.png) -1. Haga clic en **Done**(Listo). +1. Click **Done**. {% ifversion ghae %} -### Aprovisionar el acceso para grupos de Okta +### Provisioning access for Okta groups -Puedes asignar tu grupo de Okta a un equipo en {% data variables.product.product_name %}. Los miembros del grupo de Okta se convertirán automáticamente en miembros del equipo de {% data variables.product.product_name %} asignado. Para más información, vea "[Asignación de grupos de Okta a equipos](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/mapping-okta-groups-to-teams)". +You can map your Okta group to a team in {% data variables.product.product_name %}. Members of the Okta group will then automatically become members of the mapped {% data variables.product.product_name %} team. For more information, see "[Mapping Okta groups to teams](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/mapping-okta-groups-to-teams)." {% endif %} -## Información adicional +## Further reading -- [Descripción de SAML](https://developer.okta.com/docs/concepts/saml/) en la documentación de Okta -- [Descripción de SCIM](https://developer.okta.com/docs/concepts/scim/) en la documentación de Okta +- [Understanding SAML](https://developer.okta.com/docs/concepts/saml/) in the Okta documentation +- [Understanding SCIM](https://developer.okta.com/docs/concepts/scim/) in the Okta documentation diff --git a/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise.md b/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise.md index f426f508cdb1..3b0ae254b7d8 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise.md +++ b/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise.md @@ -1,7 +1,7 @@ --- -title: Configuración del aprovisionamiento de usuarios con SCIM para la empresa -shortTitle: Configure user provisioning -intro: 'Puedes configurar System for Cross-domain Identity Management (SCIM) para {% ifversion scim-for-ghes %}{% data variables.location.product_location %}{% elsif ghae %}{% data variables.product.product_name %}{% endif %}, que aprovisiona automáticamente las cuentas de usuario al asignar la aplicación para {% ifversion scim-for-ghes %}tu instancia{% elsif ghae %}{% data variables.product.product_name %}{% endif %} a un usuario en el proveedor de identidades (IdP).' +title: Configuring user provisioning with SCIM for your enterprise +shortTitle: Configure SCIM user provisioning +intro: 'You can configure System for Cross-domain Identity Management (SCIM) for {% ifversion scim-for-ghes %}{% data variables.location.product_location %}{% elsif ghae %}{% data variables.product.product_name %}{% endif %}, which automatically provisions user accounts when you assign the application for {% ifversion scim-for-ghes %}your instance{% elsif ghae %}{% data variables.product.product_name %}{% endif %} to a user on your identity provider (IdP).' permissions: '{% ifversion scim-for-ghes %}Site administrators{% elsif ghae %}Enterprise owners{% endif %} can configure user provisioning for {% ifversion scim-for-ghes %}a {% data variables.product.product_name %} instance{% elsif ghae %}an enterprise on {% data variables.product.product_name %}{% endif %}.' versions: ghae: '*' @@ -17,56 +17,61 @@ redirect_from: - /admin/authentication/configuring-user-provisioning-for-your-enterprise - /admin/identity-and-access-management/managing-iam-for-your-enterprise/configuring-user-provisioning-for-your-enterprise - /admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-for-your-enterprise -ms.openlocfilehash: c330d8e375522901d2738b581a897d42d30d628e -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148109920' --- + {% data reusables.scim.ghes-beta-note %} -## Acerca del aprovisionamiento de usuarios para {% data variables.product.product_name %} +## About user provisioning for {% data variables.product.product_name %} {% ifversion ghae %} -{% data reusables.saml.ae-uses-saml-sso %} Para obtener más información, consulta "[Configuración del inicio de sesión único de SAML para la empresa](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise)". +{% data reusables.saml.ae-uses-saml-sso %} For more information, see "[Configuring SAML single sign-on for your enterprise](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise)." {% endif %} -{% ifversion scim-for-ghes %}Si usas el inicio de sesión único (SSO) de SAML para {% data variables.location.product_location %},{% elsif ghae %}Tú{% endif %} puedes configurar SCIM a fin de crear o suspender automáticamente cuentas de usuario y conceder acceso{% ifversion scim-for-ghes %} a la instancia{% elsif ghae %} para {% data variables.product.product_name %}{% endif %} al asignar o anular la asignación de la aplicación en el IdP. Para obtener más información sobre SCIM, consulta [System for Cross-domain Identity Management: Protocolo (RFC 7644)](https://tools.ietf.org/html/rfc7644) en el sitio web de IETF. +{% ifversion scim-for-ghes %}If you use SAML single sign-on (SSO) for {% data variables.location.product_location %}, you{% elsif ghae %}You{% endif %} can configure SCIM to automatically create or suspend user accounts and grant access{% ifversion scim-for-ghes %} to your instance{% elsif ghae %} for {% data variables.product.product_name %}{% endif %} when you assign or unassign the application on your IdP. For more information about SCIM, see [System for Cross-domain Identity Management: Protocol (RFC 7644)](https://tools.ietf.org/html/rfc7644) on the IETF website. -Si no configuras el aprovisionamiento de usuarios con SCIM, el IdP no se comunicará con {% data variables.product.product_name %} automáticamente al asignar la aplicación a un usuario o anular su asignación. Sin SCIM, {% data variables.product.product_name %} crea una cuenta de usuario mediante el aprovisionamiento Just-In-Time (JIT) de SAML la primera vez que alguien navega a {% data variables.product.product_name %} e inicia sesión mediante la autenticación a través de su IdP. +If you do not configure user provisioning with SCIM, your IdP will not communicate with {% data variables.product.product_name %} automatically when you assign or unassign the application to a user. Without SCIM, {% data variables.product.product_name %} creates a user account using SAML Just-in-Time (JIT) provisioning the first time someone navigates to {% data variables.product.product_name %} and signs in by authenticating through your IdP. -Configurar el aprovisionamiento permite a tu IdP comunicarse con {% data variables.location.product_location %} cuando asignas o anulas la asignación de la aplicación para {% data variables.product.product_name %} a un usuario en tu IdP. Cuando asignas la aplicación, tu IdP pedirá que {% data variables.location.product_location %} cree una cuenta y enviará un correo electrónico de incorporación al usuario. Cuando desasignas la aplicación, tu IdP se comunicará con {% data variables.product.product_name %} para invalidad cualquier sesión de SAML e inhabilitar la cuenta del miembro. +Configuring provisioning allows your IdP to communicate with {% data variables.location.product_location %} when you assign or unassign the application for {% data variables.product.product_name %} to a user on your IdP. When you assign the application, your IdP will prompt {% data variables.location.product_location %} to create an account and send an onboarding email to the user. When you unassign the application, your IdP will communicate with {% data variables.product.product_name %} to invalidate any SAML sessions and disable the member's account. -Para configurar el aprovisionamiento para tu empresa, debes inhabilitar el aprovisionamiento en {% data variables.product.product_name %} y posteriormente instalar y configurar una aplicación de aprovisionamiento en tu IdP. +To configure provisioning for your enterprise, you must enable provisioning on {% data variables.product.product_name %}, then install and configure a provisioning application on your IdP. {% ifversion scim-for-ghes %} -La aplicación de aprovisionamiento en tu IdP se comunica con {% data variables.product.product_name %} con la API de SCIM. Para obtener más información, consulta "[SCIM](/rest/enterprise-admin/scim)" en la documentación de la API REST. +The provisioning application on your IdP communicates with {% data variables.product.product_name %} using the SCIM API. For more information, see "[SCIM](/rest/enterprise-admin/scim)" in the REST API documentation. {% endif %} -## Acerca de las identidades y las notificaciones +## About identities and claims -Después de que un administrador de IdP conceda a una persona acceso a {% data variables.location.product_location %}, el usuario puede autenticarse mediante el IdP para acceder a {% data variables.product.product_name %} mediante el inicio de sesión único de SAML. +After an IdP administrator grants a person access to {% data variables.location.product_location %}, the user can authenticate through the IdP to access {% data variables.product.product_name %} using SAML SSO. -Durante la autenticación, {% ifversion scim-for-ghes %}la instancia{% elsif ghae %}{% data variables.product.product_name %}{% endif %} intenta asociar el usuario con una identidad SAML. De manera predeterminada, {% ifversion scim-for-ghes %}la instancia{% elsif ghae %}{% data variables.product.product_name %}{% endif %} compara la notificación `NameID` del IdP con el nombre de usuario de la cuenta. {% data variables.product.product_name %} normaliza el valor de `NameID` para la comparación. A fin de obtener más información sobre la normalización del nombre de usuario, consulta "[Consideraciones sobre el nombre de usuario para la autenticación externa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication#about-username-normalization)". +During authentication, {% ifversion scim-for-ghes %}the instance{% elsif ghae %}{% data variables.product.product_name %}{% endif %} attempts to associate the user with a SAML identity. By default, {% ifversion scim-for-ghes %}the instance{% elsif ghae %}{% data variables.product.product_name %}{% endif %} compares the `NameID` claim from the IdP to the account's username. {% data variables.product.product_name %} normalizes the value of `NameID` for the comparison. For more information about username normalization, see "[Username considerations for external authentication](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication#about-username-normalization)." -Si no hay ningún nombre de usuario coincidente en la instancia, esta crea una cuenta para el usuario. Si hay una cuenta con un nombre de usuario coincidente en la instancia, el usuario inicia sesión en la cuenta.{% ifversion scim-for-ghes %} {% data variables.product.product_name %} compara la notificación del IdP con todas las cuentas de la instancia, independientemente de si estas usan autenticación integrada o ya están asociadas a una identidad SAML.{% endif %} +If there is no existing account with a matching username on the instance, the user will fail to sign in.{% ifversion scim-for-ghes %} To make this match, {% data variables.product.product_name %} compares the SAML `NameId` claim from the IdP to the `username` claim for each user account provisioned by SCIM on the instance.{% endif %} {% ifversion scim-for-ghes %} -Al usar el inicio de sesión único de SAML, un administrador de sitio puede configurar atributos de usuario personalizados para la instancia. Un atributo de nombre de usuario personalizado permitirá que la instancia use un valor del IdP distinto de `NameID`. {% data variables.product.product_name %} respetará esta asignación cuando se configure SCIM. Para obtener más información sobre la asignación de atributos de usuario, consulta "[Configuración del inicio de sesión único de SAML para la empresa](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise#configuring-saml-sso)". +{% note %} + +**Note**: During SAML authentication, some environments may use a value other than `NameID` as the unique identifying claim. Currently, if you use SCIM provisioning, custom mappings for SAML user attributes are not supported. + +{% endnote %} {% endif %} -Si {% data variables.product.product_name %} identifica correctamente a un usuario del IdP, pero los detalles de la cuenta, como la dirección de correo electrónico, el nombre o el apellido no coinciden, la instancia actualizará los detalles con valores del IdP. +If {% data variables.product.product_name %} successfully identifies a user from the IdP, but account details such as email address, first name, or last name don't match, the instance overwrites the details with values from the IdP. Any email addresses other than the primary email provisioned by SCIM will also be deleted from the user account. + +## Supported identity providers + +{% ifversion ghes %} -## Proveedores de identidad compatibles +During the private beta, your account team will provide documentation for the configuration of SCIM for {% data variables.product.product_name %} on a supported IdP. -Los IdP siguientes admiten el aprovisionamiento de usuarios con SCIM para {% data variables.product.product_name %}. +{% elsif ghae %} + +The following IdPs support user provisioning with SCIM for {% data variables.product.product_name %}. {% data reusables.saml.okta-ae-sso-beta %} @@ -76,63 +81,72 @@ Los IdP siguientes admiten el aprovisionamiento de usuarios con SCIM para {% dat {% data reusables.scim.ghes-scim-idp-table %} -{% ifversion ghae %} Para los IdP que son compatibles con la asignación de equipos, puedes asignar o anular la asignación de la aplicación de {% data variables.product.product_name %} a los grupos de usuarios en tu IdP. Luego, estos grupos estarán disponibles para que los propietarios de la organización y los mantenedores de equipos en {% data variables.location.product_location %} los asignen a los equipos de {% data variables.product.product_name %}. Para más información, vea "[Asignación de grupos de Okta a equipos](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/mapping-okta-groups-to-teams)". +For IdPs that support team mapping, you can assign or unassign the application for {% data variables.product.product_name %} to groups of users in your IdP. These groups are then available to organization owners and team maintainers in {% data variables.location.product_location %} to map to {% data variables.product.product_name %} teams. For more information, see "[Mapping Okta groups to teams](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/mapping-okta-groups-to-teams)." + {% endif %} -## Requisitos previos +## Prerequisites {% ifversion ghae %} -- Debes configurar el inicio de sesión único de SAML al inicializar {% data variables.product.product_name %}. Para obtener más información, consulte "[Inicialización de {% data variables.product.prodname_ghe_managed %}](/admin/configuration/initializing-github-ae)". +- You must configure SAML SSO when you initialize {% data variables.product.product_name %}. For more information, see "[Initializing {% data variables.product.prodname_ghe_managed %}](/admin/configuration/initializing-github-ae)." {% elsif scim-for-ghes %} - {% data reusables.saml.ghes-you-must-configure-saml-sso %} -- Debes permitir la autenticación integrada para los usuarios que no tengan una cuenta en el IdP. Para obtener más información, consulta "[Permiso para la autenticación integrada para usuarios fuera del proveedor](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider)". +- You must allow built-in authentication for users who don't have an account on your IdP. For more information, see "[Allowing built-in authentication for users outside your provider](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider)." -- El IdP debe admitir la realización de llamadas SCIM a un proveedor de servicios (SP). +- Your IdP must support making SCIM calls to a Service Provider (SP). {% endif %} -- Debes tener acceso administrativo en tu IdP para configurar la aplicación para el aprovisionamiento de usuarios para {% data variables.product.product_name %}. +- You must have administrative access on your IdP to configure the application for user provisioning for {% data variables.product.product_name %}. -## Habilitar el aprovisionamiento de usuarios para tu empresa +## Enabling user provisioning for your enterprise {% ifversion scim-for-ghes %} -Para realizar acciones de aprovisionamiento en la instancia, crearás una cuenta de usuario de máquina dedicada y promoverás la cuenta a un propietario de la empresa. +To perform provisioning actions on your instance, you will create a built-in user account and promote the account to an enterprise owner. -Después de habilitar SCIM en una instancia de {% data variables.product.product_name %}, se suspenden todas las cuentas de usuario. Si concedes al usuario acceso a la instancia desde el IdP y este usuario se autentica correctamente, se anulará la suspensión de la cuenta del usuario. +After you enable SCIM on a {% data variables.product.product_name %} instance, all user accounts are suspended. The built-in user account will continue to perform provisioning actions. After you grant a user access to your instance from your IdP, the IdP will communicate with the instance using SCIM to unsuspend the user's account. {% endif %} {%- ifversion ghae %} -1. Mientras tengas una sesión iniciada en {% data variables.location.product_location %} como propietario de empresa, crea un {% data variables.product.pat_v1 %} con el ámbito **admin:enterprise**. Para obtener más información, consulta "[Creación de un {% data variables.product.pat_generic %}](/github/authenticating-to-github/creating-a-personal-access-token)". +1. While signed into {% data variables.location.product_location %} as an enterprise owner, create a {% data variables.product.pat_v1 %} with **admin:enterprise** scope. For more information, see "[Creating a {% data variables.product.pat_generic %}](/github/authenticating-to-github/creating-a-personal-access-token)." {% note %} - **Notas**: - - A fin de crear el {% data variables.product.pat_generic %}, te recomendamos utilizar la cuenta para el primer propietario empresarial que creaste durante la inicialización. Para obtener más información, consulte "[Inicialización de {% data variables.product.prodname_ghe_managed %}](/admin/configuration/initializing-github-ae)". - - Necesitarás que este {% data variables.product.pat_generic %} configure la aplicación para SCIM en tu IdP. Almacena el token de manera segura en un administrador de contraseñas hasta que lo necesites nuevamente más adelante en estas instrucciones. + **Notes**: + - To create the {% data variables.product.pat_generic %}, we recommend using the account for the first enterprise owner that you created during initialization. For more information, see "[Initializing {% data variables.product.prodname_ghe_managed %}](/admin/configuration/initializing-github-ae)." + - You'll need this {% data variables.product.pat_generic %} to configure the application for SCIM on your IdP. Store the token securely in a password manager until you need the token again later in these instructions. - {% endnote %} {% warning %} + {% endnote %} + {% warning %} - **Advertencia**: Si la cuenta de usuario para el propietario de la empresa que crea el {% data variables.product.pat_generic %} se desactiva o desaprovisiona, tu IdP ya no aprovisionará ni desaprovisionará cuentas de usuario para la empresa automáticamente. Otro propietario de empresa debe crear un {% data variables.product.pat_generic %} y volver a configurar el aprovisionamiento en el IdP. + **Warning**: If the user account for the enterprise owner who creates the {% data variables.product.pat_generic %} is deactivated or deprovisioned, your IdP will no longer provision and deprovision user accounts for your enterprise automatically. Another enterprise owner must create a new {% data variables.product.pat_generic %} and reconfigure provisioning on the IdP. - {% endwarning %} {%- elsif scim-for-ghes %} -1. Crea una cuenta de usuario de máquina dedicada para realizar acciones de aprovisionamiento en la instancia. Para obtener más información, consulta "[Permiso para la autenticación integrada para usuarios fuera del proveedor](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider#inviting-users-outside-your-provider-to-authenticate-to-your-instance)". -1. Promueve la cuenta de usuario dedicada a un propietario de la empresa. Para más información, vea "[Invitación a usuarios a administrar la empresa](/admin/user-management/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise#adding-an-enterprise-administrator-to-your-enterprise-account)". -1. Inicia sesión en la instancia como el nuevo propietario de la empresa. -1. Crea un {% data variables.product.pat_v1 %} con el ámbito **admin:enterprise**. Para obtener más información, consulta "[Creación de un {% data variables.product.pat_generic %}](/github/authenticating-to-github/creating-a-personal-access-token)". + {% endwarning %} +{%- elsif scim-for-ghes %} +1. Create a built-in user account to perform provisioning actions on your instance. For more information, see "[Allowing built-in authentication for users outside your provider](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider#inviting-users-outside-your-provider-to-authenticate-to-your-instance)." +1. Promote the dedicated user account to an enterprise owner. For more information, see "[Inviting people to manage your enterprise](/admin/user-management/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise#adding-an-enterprise-administrator-to-your-enterprise-account)." +1. Sign into your instance as the new enterprise owner. +1. Create a {% data variables.product.pat_v1 %} with **admin:enterprise** scope. Do not specify an expiration date for the {% data variables.product.pat_v1 %}. For more information, see "[Creating a {% data variables.product.pat_generic %}](/github/authenticating-to-github/creating-a-personal-access-token)." + {% warning %} + + **Warning**: Ensure that you don't specify an expiration date for the {% data variables.product.pat_v1 %}. If you specify an expiration date, SCIM will no longer function after the expiration date passes. + + {% endwarning %} {% note %} - **Nota**: Necesitarás este {% data variables.product.pat_generic %} a fin de probar la configuración de SCIM y configurar la aplicación para SCIM en el IdP. Almacena el token de manera segura en un administrador de contraseñas hasta que lo necesites nuevamente más adelante en estas instrucciones. + **Note**: You'll need this {% data variables.product.pat_generic %} to test the SCIM configuration, and to configure the application for SCIM on your IdP. Store the token securely in a password manager until you need the token again later in these instructions. - {% endnote %} {% data reusables.enterprise_installation.ssh-into-instance %} -1. Para habilitar SCIM, ejecuta los comandos que proporciona el administrador de cuentas en {% data variables.contact.contact_enterprise_sales %}. + {% endnote %} +{% data reusables.enterprise_installation.ssh-into-instance %} +1. To enable SCIM, run the commands provided to you by your account manager on {% data variables.contact.contact_enterprise_sales %}. {% data reusables.enterprise_site_admin_settings.wait-for-configuration-run %} -1. Para validar que SCIM está operativo, ejecuta los comandos siguientes. Reemplaza _PAT FROM STEP 3_ y _YOUR INSTANCE'S HOSTNAME_ por valores reales. +1. To validate that SCIM is operational, run the following commands. Replace _PAT FROM STEP 3_ and _YOUR INSTANCE'S HOSTNAME_ with actual values. ```shell $ GHES_PAT="PAT FROM STEP 3" @@ -142,25 +156,30 @@ Después de habilitar SCIM en una instancia de {% data variables.product.product --header 'Authorization: Bearer $GHES_PAT' ``` - El comando debe devolver una matriz vacía. -{%- endif %} {%- ifversion ghae %} {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} -1. En "Aprovisionamiento de usuarios de SCIM", selecciona **Requerir aprovisionamiento de usuarios de SCIM**. - ![Casilla "Requerir aprovisionamiento de usuarios de SCIM" en la configuración de seguridad empresarial](/assets/images/help/enterprises/settings-require-scim-user-provisioning.png) -1. Haga clic en **Save**(Guardar). - ![Botón guardar en "Requerir aprovisionamiento de usuarios de SCIM" en la configuración de seguridad empresarial](/assets/images/help/enterprises/settings-scim-save.png) {%- endif %} -1. Configura el aprovisionamiento de usuarios en la aplicación para {% data variables.product.product_name %} en tu IdP. - - {%- ifversion ghae %} Los siguientes IdP proporcionan documentación acerca de cómo configurar el aprovisionamiento para {% data variables.product.product_name %}. Si no se lista tu IdP, por favor, contáctalo para solicitar soporte para {% data variables.product.product_name %}. - {%- elsif scim-for-ghes %} {% data variables.product.company_short %} proporciona documentación para configurar el aprovisionamiento de los siguientes IdP.{% endif %} - - | IdP | Más información | + The command should return an empty array. +{%- endif %} +{%- ifversion ghae %} +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.security-tab %} +1. Under "SCIM User Provisioning", select **Require SCIM user provisioning**. + ![Checkbox for "Require SCIM user provisioning" within enterprise security settings](/assets/images/help/enterprises/settings-require-scim-user-provisioning.png) +1. Click **Save**. + ![Save button under "Require SCIM user provisioning" within enterprise security settings](/assets/images/help/enterprises/settings-scim-save.png) +{%- endif %} +1. Configure user provisioning in the application for {% data variables.product.product_name %} on your IdP.{% ifversion scim-for-ghes %} To request documentation for a supported IdP, contact your account manager on {% data variables.contact.contact_enterprise_sales %}. If your IdP is unsupported, you must create the application and configure SCIM manually.{% elsif ghae %} + + The following IdPs provide documentation about configuring provisioning for {% data variables.product.product_name %}. If your IdP isn't listed, please contact your IdP to request support for {% data variables.product.product_name %}. + + | IdP | More information | | :- | :- | - | Azure AD | {% ifversion ghae %}[Tutorial: Configuración de {% data variables.product.prodname_ghe_managed %} para el aprovisionamiento de usuarios automático](https://docs.microsoft.com/azure/active-directory/saas-apps/github-ae-provisioning-tutorial) en Microsoft Docs. {% endif %}A fin de configurar Azure AD para {% data variables.product.product_name %}, consulta "[Configuración de la autenticación y el aprovisionamiento para la empresa mediante Azure AD](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad)". | -| Okta | {% ifversion ghae %}(beta){% endif %} A fin de configurar Okta para {% data variables.product.product_name %}, consulta "[Configuración de la autenticación y el aprovisionamiento para la empresa mediante Okta](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-okta)". | + | Azure AD | [Tutorial: Configure {% data variables.product.prodname_ghe_managed %} for automatic user provisioning](https://docs.microsoft.com/azure/active-directory/saas-apps/github-ae-provisioning-tutorial) in the Microsoft Docs. To configure Azure AD for {% data variables.product.product_name %}, see "[Configuring authentication and provisioning for your enterprise using Azure AD](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad)." | + | Okta | (beta) To configure Okta for {% data variables.product.product_name %}, see "[Configuring authentication and provisioning for your enterprise using Okta](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-okta)." | - La aplicación en tu IdP requiere dos valores para aprovisionar o desaprovisionar las cuentas de usuario en {% data variables.location.product_location %}. + The application on your IdP requires two values to provision or deprovision user accounts on {% data variables.location.product_location %}. - | Value | Otros nombres | Descripción | Ejemplo | + | Value | Other names | Description | Example | | :- | :- | :- | :- | - | Resolución | URL de inquilino | URL para la API de aprovisionamiento de SCIM para tu empresa en {% data variables.product.prodname_ghe_managed %} | {% data variables.product.api_url_pre %}/scim/v2 | - | Secreto compartido | {% data variables.product.pat_generic_caps %}, token secreto | Toekn para que la aplicación en tu IdP realice las tareas de aprovisionamiento en nombre de un propietario de empresa | {% data variables.product.pat_generic_caps %} que creó en el paso {% ifversion ghae %}1{% elsif scim-for-ghes %}4{% endif %} | + | URL | Tenant URL | URL to the SCIM provisioning API for your enterprise on {% data variables.product.product_name %} | {% data variables.product.api_url_pre %}/scim/v2 | + | Shared secret | {% data variables.product.pat_generic_caps %}, secret token | Token for application on your IdP to perform provisioning tasks on behalf of an enterprise owner | {% data variables.product.pat_generic_caps %} you created in step 1 | + {%- endif %} \ No newline at end of file diff --git a/translations/es-ES/content/admin/overview/about-github-for-enterprises.md b/translations/es-ES/content/admin/overview/about-github-for-enterprises.md index 4fc01bf2aadd..3d931c7b1255 100644 --- a/translations/es-ES/content/admin/overview/about-github-for-enterprises.md +++ b/translations/es-ES/content/admin/overview/about-github-for-enterprises.md @@ -17,7 +17,7 @@ topics: Developers can store and version control your source code in repositories, using issues and projects to plan and track their work. They can code in a cloud-hosted development environment, {% data variables.product.prodname_github_codespaces %}, then review each other's code changes with pull requests, using code security features to keep secrets and vulnerabilities out of your codebase. Finally, you can automate your build, test, and deployment pipeline with {% data variables.product.prodname_actions %} and host software packages with {% data variables.product.prodname_registry %}. -When businesses adopt {% data variables.product.prodname_enterprise %}, their return on investment (ROI) is high. For example, their developers save 45 minutes per day, and onboarding and training time is reduced by 40%. For more information, see [The Total Economic Impact of {% data variables.product.prodname_enterprise %}](https://resources.github.com/downloads/TEI-of-GitHub-Enterprise.pdf). +When businesses adopt {% data variables.product.prodname_enterprise %}, their return on investment (ROI) is high. For example, their developers save 45 minutes per day, and onboarding and training time is reduced by 40%. For more information, see [The Total Economic Impact of {% data variables.product.prodname_enterprise %}](https://resources.github.com/forrester/). To simplify administration for all the stages in the software development lifecycle, we provide a single point of visibility and management called an enterprise account. Enterprise accounts enable you to manage billing and settings, enforce policy, and audit the people with access to your enterprise's resources. For more information, see "[About enterprise accounts](/admin/overview/about-enterprise-accounts)." diff --git a/translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/index.md b/translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/index.md index cc1d7a645e47..0d6352a33576 100644 --- a/translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/index.md +++ b/translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/index.md @@ -21,6 +21,7 @@ children: - /enforcing-policies-for-security-settings-in-your-enterprise - /enforcing-policies-for-dependency-insights-in-your-enterprise - /enforcing-policies-for-github-actions-in-your-enterprise + - /enforcing-policies-for-github-copilot-in-your-enterprise - /enforcing-policies-for-code-security-and-analysis-for-your-enterprise - /enforcing-policies-for-personal-access-tokens-in-your-enterprise shortTitle: Enforce policies diff --git a/translations/es-ES/content/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot.md b/translations/es-ES/content/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot.md index fe4e4669352e..cbe37c847182 100644 --- a/translations/es-ES/content/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot.md +++ b/translations/es-ES/content/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot.md @@ -1,6 +1,6 @@ --- title: About billing for GitHub Copilot -intro: 'If you want to use {% data variables.product.prodname_copilot %}, you need a subscription for your {% data variables.product.prodname_dotcom %} account.' +intro: 'If you want to use {% data variables.product.prodname_copilot %}, you either need a subscription for {% data variables.product.prodname_copilot_for_individuals %} in your personal account, or you need to be assigned a seat by an organization on {% data variables.product.prodname_ghe_cloud %} with a subscription for {% data variables.product.prodname_copilot_for_business %}.' product: '{% data reusables.gated-features.copilot-billing %}' versions: feature: copilot @@ -10,12 +10,30 @@ shortTitle: Billing for GitHub Copilot --- ## About billing for {% data variables.product.prodname_copilot %} -If you want to use {% data variables.product.prodname_copilot %}, you will need a subscription for your {% data variables.product.prodname_dotcom %} personal account. For more information about {% data variables.product.prodname_copilot %}, see "[About {% data variables.product.prodname_copilot %}](/en/copilot/overview-of-github-copilot/about-github-copilot)." +If you want to use {% data variables.product.prodname_copilot %}, you will need a subscription for your {% data variables.product.prodname_dotcom %} personal account, or if you are a member of a {% data variables.product.prodname_ghe_cloud %} organization with a {% data variables.product.prodname_copilot_business_short %} subscription, you will need to be assigned a seat by an organization admin. For more information about {% data variables.product.prodname_copilot %}, see "[About {% data variables.product.prodname_copilot %}](/en/copilot/overview-of-github-copilot/about-github-copilot)." -Before starting a paid subscription, you can set up a one-time 60-day trial to evaluate {% data variables.product.prodname_copilot %}. To begin a trial, you will need to choose a monthly or yearly billing cycle, and provide a payment method. If you do not cancel the trial before the end of the 60 days, the trial will automatically convert to a paid subscription. You can cancel your {% data variables.product.prodname_copilot %} trial at any time during the 60 days and you won't be charged. If you cancel before the end of the trial, you will continue to have access to {% data variables.product.prodname_copilot %} until the 60-day trial period ends. For more information, see "[Managing your GitHub Copilot subscription](/en/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription)." +For more information about managing {% data variables.product.prodname_copilot %} through {% data variables.product.prodname_ghe_cloud %}, see "[Enforcing policies for {% data variables.product.prodname_copilot %} in your enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise){% ifversion ghec %}.{% endif %}"{% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% endif %} + +Before starting a paid subscription for a personal account, you can set up a one-time 60-day trial to evaluate {% data variables.product.prodname_copilot %}. To begin a trial, you will need to choose a monthly or yearly billing cycle, and provide a payment method. If you do not cancel the trial before the end of the 60 days, the trial will automatically convert to a paid subscription. You can cancel your {% data variables.product.prodname_copilot %} trial at any time during the 60 days and you won't be charged. If you cancel before the end of the trial, you will continue to have access to {% data variables.product.prodname_copilot %} until the 60-day trial period ends. For more information, see "[Managing your {% data variables.product.prodname_copilot_for_individuals %} subscription](/en/billing/managing-billing-for-github-copilot/managing-your-github-copilot-for-individuals-subscription)." + +## Pricing for {% data variables.product.prodname_copilot_for_individuals %} -## {% data variables.product.prodname_copilot %} pricing The {% data variables.product.prodname_copilot %} subscription is available on a monthly or yearly cycle. If you choose a monthly billing cycle, you will be billed $10 per calendar month. If you choose a yearly billing cycle, you will be billed $100 per year. You can modify your billing cycle at any time, and the modification will be reflected from the start of your next billing cycle. +If you have an active {% data variables.product.prodname_copilot %} subscription, and are then assigned a seat as part of a {% data variables.product.prodname_copilot_for_business %} subscription in {% data variables.product.prodname_ghe_cloud %}, your personal {% data variables.product.prodname_copilot %} subscription will be automatically canceled. You will receive a prorated refund for any remaining portion of your personal subscription's current billing cycle. You will then be able to continue using {% data variables.product.prodname_copilot %} according to the policies set at the enterprise or organization level. + A free subscription for {% data variables.product.prodname_copilot %} is available to verified students, teachers, and maintainers of popular open-source repositories on {% data variables.product.company_short %}. If you meet the criteria as an open source maintainer, you will be automatically notified when you visit the {% data variables.product.prodname_copilot %} subscription page. As a student, if you currently receive the {% data variables.product.prodname_student_pack %}, you will also be offered a free subscription when you visit the {% data variables.product.prodname_copilot %} subscription page. For more information about the {% data variables.product.prodname_student_pack %}, see "[Apply to {% data variables.product.prodname_global_campus %} as a student](/free-pro-team@latest/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/apply-to-github-global-campus-as-a-student)." + +{% ifversion ghec %} +## Pricing for {% data variables.product.prodname_copilot_for_business %} + +The {% data variables.product.prodname_copilot_for_business %} subscription is available on a monthly cycle, and is billed at $19 per user per month. Billing for {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_ghe_cloud %} is processed at the end of each billing cycle. + +Billed users are calculated based on the number of {% data variables.product.prodname_copilot %} seats assigned at the beginning of a billing cycle, or assigned during the billing cycle. Any seat assigned part way through the billing cycle will be prorated based on the number of days remaining in the cycle. Any seat assignment removed during a billing cycle will take effect from the beginning of the next cycle. + +Seat assignment for {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_ghe_cloud %} is managed by admins of organizations which have been granted access to {% data variables.product.prodname_copilot %} at the enterprise level. If you are a member of multiple organizations under the same enterprise, you can be assigned {% data variables.product.prodname_copilot %} seats in more than one organization, but your enterprise will only be billed once. For more information, see "[Configuring {% data variables.product.prodname_copilot %} settings in your organization](/enterprise-cloud@latest/copilot/configuring-github-copilot/configuring-github-copilot-settings-in-your-organization)." + +Policy settings and the usage overview for {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_ghe_cloud %} are available at the enterprise level. For more information, see "[Enforcing policies for {% data variables.product.prodname_copilot %} in your enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise)" and "[Viewing your {% data variables.product.prodname_copilot %} usage](/enterprise-cloud@latest/billing/managing-billing-for-github-copilot/viewing-your-github-copilot-usage)." + +{% endif %} \ No newline at end of file diff --git a/translations/es-ES/content/billing/managing-billing-for-github-copilot/index.md b/translations/es-ES/content/billing/managing-billing-for-github-copilot/index.md index f256c2dba222..fea978579c53 100644 --- a/translations/es-ES/content/billing/managing-billing-for-github-copilot/index.md +++ b/translations/es-ES/content/billing/managing-billing-for-github-copilot/index.md @@ -1,17 +1,12 @@ --- -title: Administración de la facturación para GitHub Copilot +title: Managing billing for GitHub Copilot shortTitle: GitHub Copilot -intro: 'Puedes probar {% data variables.product.prodname_copilot %} con una evaluación gratuita antes de iniciar la suscripción, y modificar o cancelar la suscripción en cualquier momento.' +intro: 'You can try {% data variables.product.prodname_copilot_for_individuals %} with a free trial before starting your subscription, and modify or cancel your subscription at any time. You can also view your usage of {% data variables.product.prodname_copilot_for_business %}, and learn about how the costs are calculated.' versions: feature: copilot children: - /about-billing-for-github-copilot - - /managing-your-github-copilot-subscription -ms.openlocfilehash: 96947819762933ad78544da4b8347cbc5efef646 -ms.sourcegitcommit: 1309b46201604c190c63bfee47dce559003899bf -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: '147080719' + - /managing-your-github-copilot-for-individuals-subscription + - /viewing-your-github-copilot-usage --- diff --git a/translations/es-ES/content/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription.md b/translations/es-ES/content/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription.md deleted file mode 100644 index 3cd29f0809e9..000000000000 --- a/translations/es-ES/content/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: Managing your GitHub Copilot subscription -intro: 'Set up your {% data variables.product.prodname_copilot %} trial and manage your subscription.' -product: '{% data reusables.gated-features.copilot-billing %}' -versions: - feature: copilot -type: how_to -topics: - - Copilot -shortTitle: Your GitHub Copilot subscription ---- - -## Setting up a trial of {% data variables.product.prodname_copilot %} - -{% data reusables.copilot.signup-procedure %} - -## Modifying your {% data variables.product.prodname_copilot %} subscription - -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.billing_plans %} -1. In the "{% data variables.product.prodname_copilot %}" section, select the **Edit** dropdown. - - If you are on a monthly billing cycle, select **Change to yearly billing**. - - If you are on a yearly billing cycle, select **Change to monthly billing**. - ![Screenshot of GitHub Copilot section on billing page with edit dropdown emphasized](/assets/images/help/copilot/copilot-settings-edit-dropdown.png) - - -## Canceling your {% data variables.product.prodname_copilot %} subscription - -You can cancel your {% data variables.product.prodname_copilot %} subscription at any time. If you cancel during your 60 day trial, you won't be charged. If you do not cancel your {% data variables.product.prodname_copilot %} subscription before the end of the 60 day trial, you will be charged according to the billing cycle you selected when setting up the trial. - -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.billing_plans %} -1. In the "{% data variables.product.prodname_copilot %}" section, select the **Edit** dropdown. - - If you have a paid subscription, click **Cancel {% data variables.product.prodname_copilot %}**. - - ![Screenshot of GitHub Copilot section on billing page with cancel GitHub Copilot option emphasized](/assets/images/help/copilot/copilot-billing-edit-dropdown.png) - - - If you are within your 60 day trial period, click **Cancel trial**. - ![Screenshot of GitHub Copilot section on billing page with cancel trial option emphasized](/assets/images/help/copilot/copilot-cancel-trial.png) - -2. In the "Cancel {% data variables.product.prodname_copilot %}" modal, click **I understand, cancel {% data variables.product.prodname_copilot %}** - - ![Screenshot of GitHub Copilot cancel modal with I understand, cancel GitHub Copilot button emphasized](/assets/images/help/copilot/copilot-cancel-modal.png) - - - If you are within your 60 day trial period, click **I understand, cancel {% data variables.product.prodname_copilot %} trial**. - - ![Screenshot of GitHub Copilot cancel trial modal with I understand, cancel trial button emphasized](/assets/images/help/copilot/copilot-trial-cancel-modal.png) - -## Further reading - -- [About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot) -- [Getting started with {% data variables.product.prodname_copilot %}](/copilot/getting-started-with-github-copilot) diff --git a/translations/es-ES/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md b/translations/es-ES/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md deleted file mode 100644 index ab0baf96c086..000000000000 --- a/translations/es-ES/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md +++ /dev/null @@ -1,125 +0,0 @@ ---- -title: Permitir que tu codespace acceda a una imagen de registro privada -intro: 'Puedes utilizar secretos para permitir que los {% data variables.product.prodname_github_codespaces %} accedan a un registro de imagen privada' -versions: - fpt: '*' - ghec: '*' -topics: - - Codespaces -shortTitle: Private image registry -ms.openlocfilehash: c11cfe0179856caf17f30ac32830ee1485defa3c -ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/09/2022 -ms.locfileid: '148159209' ---- -## Acerca de los registros de imagen y {% data variables.product.prodname_github_codespaces %} - -Un registro es un espacio seguro para almacenar, administrar y recuperar imágenes de contenedor privadas. Puedes utilizar uno para almacenar una o más imágenes. Hay muchos ejemplos de registros, tales como {% data variables.product.prodname_container_registry %}, {% data variables.product.prodname_npm_registry %}, Azure Container Registry o DockerHub. - -{% data variables.packages.prodname_ghcr_and_npm_registry %} se puede configurar para permitir que las imágenes de contenedor se extraigan sin problemas a {% data variables.product.prodname_github_codespaces %} durante la creación del codespace, sin tener que proporcionar credenciales de autenticación. Para otros registros de imágenes, debes crear secretos en {% data variables.product.prodname_dotcom %} para almacenar los detalles de acceso, los cuales permitirán que los {% data variables.product.prodname_github_codespaces %} accedan a las imágenes almacenadas en dicho registro. - -## Acceso a las imágenes almacenadas en {% data variables.packages.prodname_ghcr_and_npm_registry %} - -{% data variables.packages.prodname_ghcr_and_npm_registry %} proporciona la manera más fácil de que {% data variables.product.prodname_github_codespaces %} consuma imágenes de contenedor de desarrollo. - -Para obtener más información, consulta «[Trabajar con el registro de contenedor](/packages/working-with-a-github-packages-registry/working-with-the-container-registry)» y «[Trabajar con el registro npm](/packages/working-with-a-github-packages-registry/working-with-the-npm-registry)». - -### Acceder a una imagen publicada en el mismo repositorio que el codespace - -Si publicas una imagen de contenedor en {% data variables.packages.prodname_ghcr_or_npm_registry %} en el mismo repositorio en el que se está iniciando el codespace, podrás recuperar automáticamente esta imagen cuando crees el codespace. No tendrá que proporcionar credenciales adicionales, a menos que la opción **Heredar acceso del repositorio** se haya desactivado al publicar la imagen de contenedor. - -#### Heredar el acceso del repositorio desde el cual se publicó la imagen - -De forma predeterminada, cuando publicas una imagen de contenedor en {% data variables.packages.prodname_ghcr_or_npm_registry %}, la imagen hereda la configuración de acceso del repositorio desde el cual ha sido publicada. Por ejemplo, si el repositorio es público, la imagen también es pública. Si el repositorio es privado, la imagen también es privada, pero es accesible desde el repositorio. - -Este comportamiento se controla mediante la opción **Heredar acceso del repositorio**. **Heredar acceso del repositorio** se selecciona de manera predeterminada al publicar desde {% data variables.product.prodname_actions %}, pero no cuando se publica directamente en {% data variables.packages.prodname_ghcr_or_npm_registry %} con un {% data variables.product.pat_generic %}. - -Si la opción **Heredar acceso del repositorio** no se ha seleccionado al publicar la imagen, puede agregar el repositorio manualmente a los controles de acceso de la imagen del contenedor publicado. Para más información, vea "[Configuración del control de acceso y la visibilidad de un paquete](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#inheriting-access-for-a-container-image-from-a-repository)". - -### Acceder a una imagen publicada en la organización en la cual se lanzará un codespace - -Si quieres que todos los codespaces en una organización puedan acceder a una imagen de contenedor, te recomendamos que la publiques con visibilidad interna. Esto hará que la imagen sea automáticamente visible para todos los codespaces dentro de la organización, a menos de que el repositorio desde el cual se lanzó el codespace sea público. - -Si el codespace se está lanzando desde un repositorio público que referencia una imagen privada o interna, debes permitir manualmente que el repositorio público acceda a la imagen de contenedor interna. Esto previene que la imagen interna se filtre accidentalmente al público. Para más información, vea "[Garantía del acceso de Codespaces al paquete](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-codespaces-access-to-your-package)". - -### Acceder a un contenedor privado desde un subconjunto de repositorios en una organización - -Si quiere permitir que un subconjunto de los repositorios de una organización accedan a una imagen de contenedor, o bien permitir el acceso a una imagen privada o interna desde un codespace iniciado en un repositorio público, puede agregar repositorios manualmente a la configuración de acceso de la imagen del contenedor. Para más información, vea "[Garantía del acceso de Codespaces al paquete](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-codespaces-access-to-your-package)." - -### Publicar una imagen de contenedor desde un codespace - -El acceso fácil desde un codespace a {% data variables.packages.prodname_ghcr_or_npm_registry %} se limita a la extracción de imágenes de contenedor. Si quieres publicar una imagen de contenedor desde dentro de un codespace, tendrás que usar un {% data variables.product.pat_v1 %} con el ámbito `write:packages`. - -Te recomendamos publicar imágenes a través de {% data variables.product.prodname_actions %}. Para obtener más información, consulta «[Publicación de imágenes de Docker](/actions/publishing-packages/publishing-docker-images)» y «[Publicación de paquetes Node.js](/actions/publishing-packages/publishing-nodejs-packages)». - -## Acceder a las imágenes almacenadas en otros registros de contenedor - -Si estás accediendo a una imagen de contenedor desde un registro diferente a {% data variables.packages.prodname_ghcr_or_npm_registry %}, {% data variables.product.prodname_github_codespaces %} verifica la presencia de los tres secretos que definen el nombre del servidor, el nombre de usuario y {% data variables.product.pat_generic %} para un registro de contenedores. Si se encuentran estos secretos, {% data variables.product.prodname_github_codespaces %} hará que el registro esté disponible dentro de tu codespace. - -- `<*>_CONTAINER_REGISTRY_SERVER` -- `<*>_CONTAINER_REGISTRY_USER` -- `<*>_CONTAINER_REGISTRY_PASSWORD` - -Puedes almacenar los secretos a nivel de repositorio, organización o usuario, lo cual te permite compartirlos de forma segura entre diferentes codespaces. Cuando creas un conjunto de secretos para un registro de imagen privado, necesitas reemplazar el "<*>” del nombre con un identificador consistente. Para más información, consulta "[Administración de secretos cifrados para los codespaces](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)" y "[Administración de secretos cifrados para el repositorio y la organización para {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces)." - -Si estás configurando secretos a nivel de organización o de usuario, asegúrate de asignarlos al repositorio en el que crearás el codespace eligiendo una política de acceso desde la lista desplegable. - -![Ejemplo de secreto de registro de imagen](/assets/images/help/codespaces/secret-repository-access.png) - -### Secretos de ejemplo - -Para los registros de imagen privados en Azure, podrías crear los siguientes secretos: - -``` -ACR_CONTAINER_REGISTRY_SERVER = mycompany.azurecr.io -ACR_CONTAINER_REGISTRY_USER = acr-user-here -ACR_CONTAINER_REGISTRY_PASSWORD = -``` - -Para obtener información sobre los registros de imágenes comunes, vea "[Servidores comunes de registro de imágenes](#common-image-registry-servers)". Toma en cuenta que el acceso a AWS Elastic Container Registry (ECR) será diferente. - -![Ejemplo de secreto de registro de imagen](/assets/images/help/settings/codespaces-image-registry-secret-example.png) - -Una vez que hayas agregado los secretos, podría ser que necesites parar y luego iniciar el codespace en el que estás para que las variables de ambiente nuevas pasen en el contenedor. Para más información, vea "[Suspensión o detención de un codespace](/codespaces/codespaces-reference/using-the-command-palette-in-codespaces#suspending-or-stopping-a-codespace)". - -#### Acceder a AWS Elastic Container Registry - -Para acceder a AWS Elastic Container Registry (ECR), puedes proporcionar una ID de llave de acceso de AWS y una llave secreta y {% data variables.product.prodname_dotcom %} podrá recuperar un token de acceso para ti e iniciar sesión en tu nombre. - -``` -*_CONTAINER_REGISTRY_SERVER = -*_CONTAINER_REGISTRY_USER = -*_CONTAINER_REGISTRY_PASSWORD = -``` - -También debe asegurarse de que tiene los permisos IAM de AWS adecuados para realizar el intercambio de credenciales (por ejemplo, `sts:GetServiceBearerToken`), así como la operación de lectura de ECR (ya sea `AmazonEC2ContainerRegistryFullAccess` o `ReadOnlyAccess`). - -Como alternativa, si no quieres que GitHub realice el cambio de credenciales en tu nombre, puedes proporcionar un token de autorización que se haya recuperado a través de las API de AWS o del CLI. - -``` -*_CONTAINER_REGISTRY_SERVER = -*_CONTAINER_REGISTRY_USER = AWS -*_CONTAINER_REGISTRY_PASSWORD = -``` - -Ya que estos tokens tienen una vida corta y necesitan actualizarse constantemente, te recomendamos proporcionar una ID de llave de acceso y secreto. - -Aunque estos secretos pueden tener cualquier nombre, siempre que `*_CONTAINER_REGISTRY_SERVER` sea una dirección URL de ECR, se recomienda usar `ECR_CONTAINER_REGISTRY_*`, a menos que trabaje con varios registros ECR. - -Para más información, vea la "[documentación de autenticación de registros privados](https://docs.aws.amazon.com/AmazonECR/latest/userguide/registry_auth.html)" de ECR de AWS. - -### Servidores de registro de imagen comunes - -Algunos de los servidores de registro de imagen comunes se listan a continuación: - -- [DockerHub](https://docs.docker.com/engine/reference/commandline/info/) - `https://index.docker.io/v1/` -- [Registro de contenedores de GitHub](/packages/working-with-a-github-packages-registry/working-with-the-container-registry) - `ghcr.io` -- [Azure Container Registry](https://docs.microsoft.com/azure/container-registry/) - `.azurecr.io` -- [AWS Elastic Container Registry](https://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries.html) - `.dkr.ecr..amazonaws.com` -- [Google Cloud Container Registry](https://cloud.google.com/container-registry/docs/overview#registries) - `gcr.io` (EE. UU.), `eu.gcr.io` (Europa), `asia.gcr.io` (Asia) - -## Depurar el acceso al registro de imágenes privadas - -Si tiene problemas para extraer una imagen de un registro de imágenes privadas, asegúrese de que puede ejecutar `docker login -u -p `, con los valores de los secretos definidos anteriormente. Si el inicio de sesión falla, asegúrate de que las credenciales de inicio de sesión sean válidas y de que tienes los permisos adecuados en el servidor para recuperar una imagen de contenedor. Si el inicio de sesión es exitoso, asegúrate de que estos valores se copien adecuadamente en los secretos de {% data variables.product.prodname_github_codespaces %} correctos, ya sea a nivel de usuario, repositorio u organización, e inténtalo de nuevo. diff --git a/translations/es-ES/content/codespaces/codespaces-reference/index.md b/translations/es-ES/content/codespaces/codespaces-reference/index.md index c36cb159e43a..3e68b079e4a6 100644 --- a/translations/es-ES/content/codespaces/codespaces-reference/index.md +++ b/translations/es-ES/content/codespaces/codespaces-reference/index.md @@ -5,7 +5,7 @@ versions: fpt: '*' ghec: '*' children: - - /allowing-your-codespace-to-access-a-private-image-registry + - /allowing-your-codespace-to-access-a-private-registry - /using-github-copilot-in-github-codespaces - /using-the-github-codespaces-plugin-for-jetbrains - /using-the-vs-code-command-palette-in-codespaces diff --git a/translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-in-a-jetbrains-ide.md b/translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-in-a-jetbrains-ide.md index b342abe58cd9..5fff4f1535a0 100644 --- a/translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-in-a-jetbrains-ide.md +++ b/translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-in-a-jetbrains-ide.md @@ -1,88 +1,100 @@ --- -title: Configuración de GitHub Copilot en un IDE de JetBrains -intro: 'Puedes habilitar, configurar y deshabilitar {% data variables.product.prodname_copilot %} en un IDE de JetBrains.' +title: Configuring GitHub Copilot in a JetBrains IDE +intro: 'You can enable, configure, and disable {% data variables.product.prodname_copilot %} in a JetBrains IDE.' product: '{% data reusables.gated-features.copilot %}' topics: - Copilot versions: feature: copilot shortTitle: JetBrains -ms.openlocfilehash: 845f9306f519391f165dd00d3eefebed67bd409a -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147080671' --- -## Acerca del {% data variables.product.prodname_copilot %} en IDE de JetBrains -Si usas un IDE de JetBrains, {% data variables.product.prodname_copilot %} puede autocompletar el código a medida que escribes. Después de la instalación, puedes habilitar o deshabilitar {% data variables.product.prodname_copilot %}, y configurar opciones avanzadas en el IDE o en {% data variables.product.prodname_dotcom_the_website %}. +## About {% data variables.product.prodname_copilot %} in JetBrains IDEs -## Prerrequisitos +If you use a Jetbrains IDE, {% data variables.product.prodname_copilot %} can autocomplete code as you type. After installation, you can enable or disable {% data variables.product.prodname_copilot %}, and you can configure advanced settings within your IDE or on {% data variables.product.prodname_dotcom_the_website %}. This article describes how to configure {% data variables.product.prodname_copilot %} in the IntelliJ IDE, but the user interfaces of other Jetbrains IDEs may differ. -Para configurar {% data variables.product.prodname_copilot %} en un IDE de JetBrains, hay que instalar el complemento {% data variables.product.prodname_copilot %}. Para más información, consulta "[Introducción a {% data variables.product.prodname_copilot %} en un IDE de JetBrains](/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide)". +{% data reusables.copilot.dotcom-settings %} + +## Prerequisites + +To configure {% data variables.product.prodname_copilot %} in a JetBrains IDE, you must install the {% data variables.product.prodname_copilot %} plugin. For more information, see "[Getting started with {% data variables.product.prodname_copilot %} in a JetBrains IDE](/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide)." -## Métodos abreviados de teclado para {% data variables.product.prodname_copilot %} +## Keyboard shortcuts for {% data variables.product.prodname_copilot %} -Puedes usar los métodos abreviados de teclado predeterminados para sugerencias insertadas en el IDE de JetBrains al usar {% data variables.product.prodname_copilot %}. Como alternativa, puedes volver a enlazar los accesos directos a tus métodos abreviados de teclado preferidos para cada comando específico. Para obtener más información sobre cómo volver a enlazar métodos abreviados de teclado en el IDE de JetBrains, consulta la documentación de JetBrains. Por ejemplo, puedes ver la documentación de [IntelliJ IDEA](https://www.jetbrains.com/help/idea/mastering-keyboard-shortcuts.html#choose-keymap). +You can use the default keyboard shortcuts for inline suggestions in your JetBrains IDE when using {% data variables.product.prodname_copilot %}. Alternatively, you can rebind the shortcuts to your preferred keyboard shortcuts for each specific command. For more information on rebinding keyboard shortcuts in your JetBrains IDE, see the JetBrains documentation. For example, you can view the [IntelliJ IDEA](https://www.jetbrains.com/help/idea/mastering-keyboard-shortcuts.html#choose-keymap) documentation. {% mac %} -| Acción | Acceso directo | +| Action | Shortcut | |:---|:---| -|Aceptar una sugerencia insertada|Pestaña| -|Descartar una sugerencia insertada|Esc| -|Mostrar la sugerencia insertada siguiente|Opción (⌥) o Alt+]| -|Mostrar sugerencia insertada anterior|Opción (⌥) o Alt+[| -|Desencadenar sugerencia insertada|Opción (⌥)+\| -|Abrir {% data variables.product.prodname_copilot %} (sugerencias adicionales en el panel independiente)|Opción (⌥) o Alt+Devolución | +|Accept an inline suggestion|Tab| +|Dismiss an inline suggestion|Esc| +|Show next inline suggestion|Option (⌥) or Alt+]| +|Show previous inline suggestion|Option (⌥) or Alt+[| +|Trigger inline suggestion|Option (⌥)+\| +|Open {% data variables.product.prodname_copilot %} (additional suggestions in separate pane)|Option (⌥) or Alt+Return | {% endmac %} {% windows %} -| Acción | Acceso directo | +| Action | Shortcut | |:---|:---| -|Aceptar una sugerencia insertada|Pestaña| -|Descartar una sugerencia insertada|Esc| -|Mostrar la sugerencia insertada siguiente|Alt+]| -|Mostrar sugerencia insertada anterior|Alt+[| -|Desencadenar sugerencia insertada|Alt+\| -|Abrir {% data variables.product.prodname_copilot %} (sugerencias adicionales en el panel independiente)|Alt+Entrar | +|Accept an inline suggestion|Tab| +|Dismiss an inline suggestion|Esc| +|Show next inline suggestion|Alt+]| +|Show previous inline suggestion|Alt+[| +|Trigger inline suggestion|Alt+\| +|Open {% data variables.product.prodname_copilot %} (additional suggestions in separate pane)|Alt+Enter | {% endwindows %} {% linux %} -| Acción | Acceso directo | +| Action | Shortcut | |:---|:---| -|Aceptar una sugerencia insertada|Pestaña| -|Descartar una sugerencia insertada|Esc| -|Mostrar la sugerencia insertada siguiente|Alt+]| -|Mostrar sugerencia insertada anterior|Alt+[| -|Desencadenar sugerencia insertada|Alt+\| -|Abrir {% data variables.product.prodname_copilot %} (sugerencias adicionales en el panel independiente)|Alt+Entrar | +|Accept an inline suggestion|Tab| +|Dismiss an inline suggestion|Esc| +|Show next inline suggestion|Alt+]| +|Show previous inline suggestion|Alt+[| +|Trigger inline suggestion|Alt+\| +|Open {% data variables.product.prodname_copilot %} (additional suggestions in separate pane)|Alt+Enter | {% endlinux %} -## Habilitación o deshabilitación de {% data variables.product.prodname_copilot %} +## Enabling or disabling {% data variables.product.prodname_copilot %} -Puedes habilitar o deshabilitar {% data variables.product.prodname_copilot %} desde el IDE de JetBrains. El icono de estado de {% data variables.product.prodname_copilot %} en el panel inferior de la ventana de JetBrains indica si {% data variables.product.prodname_copilot %} está habilitado o deshabilitado. Cuando está habilitado, el icono está resaltado. Cuando está deshabilitado, el icono está atenuado. +You can enable or disable {% data variables.product.prodname_copilot %} from within your JetBrains IDE. The {% data variables.product.prodname_copilot %} status icon in the bottom panel of the JetBrains window indicates whether {% data variables.product.prodname_copilot %} is enabled or disabled. When enabled, the icon is highlighted. When disabled, the icon is grayed out. -1. Para habilitar o deshabilitar {% data variables.product.prodname_copilot %}, haz clic en el icono de estado en el panel inferior de la ventana JetBrains. +1. To enable or disable {% data variables.product.prodname_copilot %}, click the status icon in the bottom panel of the JetBrains window. ![Status icon in JetBrains](/assets/images/help/copilot/status-icon-jetbrains.png) -2. Si deshabilitas {% data variables.product.prodname_copilot %}, se te preguntará si quieres deshabilitarlo de forma global o para el lenguaje del archivo que estás editando actualmente. Para deshabilitar globalmente, haz clic en **Deshabilitar finalizaciones**. Como alternativa, haz clic en el botón específico del lenguaje para deshabilitar {% data variables.product.prodname_copilot %} para el lenguaje especificado. - ![Deshabilitar {% data variables.product.prodname_copilot %} de forma global o para el lenguaje actual](/assets/images/help/copilot/disable-copilot-global-or-langugage-jetbrains.png) +2. If you are disabling {% data variables.product.prodname_copilot %}, you will be asked whether you want to disable it globally, or for the language of the file you are currently editing. To disable globally, click **Disable Completions**. Alternatively, click the language-specific button to disable {% data variables.product.prodname_copilot %} for the specified language. + ![Disable {% data variables.product.prodname_copilot %} globally or for the current language](/assets/images/help/copilot/disable-copilot-global-or-langugage-jetbrains.png) + +## Configuring advanced settings for {% data variables.product.prodname_copilot %} + +You can manage advanced settings for {% data variables.product.prodname_copilot %} in your JetBrains IDE, such as how your IDE displays code completions, and which languages you want to enable or disable for {% data variables.product.prodname_copilot %}. + +1. In your JetBrains IDE, click the **File** menu, then click **Settings**. +1. Under **Languages & Frameworks**, click **{% data variables.product.prodname_copilot %}**. +1. Edit the settings according to your personal preferences. + - To adjust the behaviour and appearance of code suggestions, and whether to automatically check for updates, select or deselect the corresponding checkboxes. + - If you have selected to receive automatic updates, you can choose whether to receive stable, but less frequent updates, or nightly updates, which may be less stable. Click the **Update channel** dropdown and select **Stable** for stable updates, or **Nightly** for nightly updates. + - Under "Disabled languages," use the checkboxes to select or deselect the languages you want to disable {% data variables.product.prodname_copilot %} for. + +## Configuring proxy settings for {% data variables.product.prodname_copilot %} + +You can configure {% data variables.product.prodname_copilot %} to connect through an HTTP proxy server in a Jetbrains IDE. {% data variables.product.prodname_copilot %} supports basic HTTP proxy setups, with or without basic authentication. + +1. In your JetBrains IDE, click the **File** menu, then click **Settings**. +1. Under **Appearance & Behavior**, click **System Settings** and then click **HTTP Proxy**. +1. Select the **Manual proxy configuration** checkbox, and then select the **HTTP** checkbox. +1. In the "Host name" field, enter the hostname of your proxy server, and in the "Port number" field, enter the port number of your proxy server. -## Configuración de opciones avanzadas para {% data variables.product.prodname_copilot %} + ![Screenshot of the HTTP proxy settings in JetBrains](/assets/images/help/copilot/proxy-configuration-jetbrains.png) -Puedes administrar la configuración avanzada de {% data variables.product.prodname_copilot %} en el IDE de JetBrains, como la forma en que el IDE muestra finalizaciones de código y los lenguajes que deseas habilitar o deshabilitar para {% data variables.product.prodname_copilot %}. +1. Optionally, in the left sidebar, click **Tools** and then click **Server Certificates**. Then select or deselect the "Accept non-trusted certificates automatically" checkbox, depending on whether you want to accept non-trusted certificates automatically. -1. En el IDE de JetBrains, haz clic en el menú **Archivo** y, a continuación, haz clic en **Configuración**. -1. En **Lenguajes y marcos**, haz clic en **{% data variables.product.prodname_copilot %}** . -1. Edita la configuración según tus preferencias personales. - - Para ajustar el comportamiento y la apariencia de las sugerencias de código, y en caso de que se busquen actualizaciones, activa o desactiva las casillas correspondientes. - - Si has seleccionado la opción para recibir actualizaciones automáticas, puedes elegir entre recibir actualizaciones estables, pero menos frecuentes, o actualizaciones nocturnas, que pueden ser menos estables. Haz clic en la lista desplegable **Canal de actualización** y selecciona **Estable** para recibir actualizaciones estables o **Por la noche** para recibir actualizaciones nocturnas. - - En "Lenguajes deshabilitados", usa las casillas para activar o desactivar los lenguajes para los que deseas deshabilitar {% data variables.product.prodname_copilot %}. + ![Screenshot of the server certificates settings in JetBrains](/assets/images/help/copilot/server-certificates-jetbrains.png) {% data reusables.copilot.dotcom-settings %} diff --git a/translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-in-visual-studio-code.md b/translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-in-visual-studio-code.md index ac215f54f5da..f1502430c1c2 100644 --- a/translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-in-visual-studio-code.md +++ b/translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-in-visual-studio-code.md @@ -1,105 +1,99 @@ --- -title: "Configuración de GitHub\_Copilot en Visual\_Studio\_Code" -intro: 'Puedes habilitar, configurar y deshabilitar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %}.' +title: Configuring GitHub Copilot in Visual Studio Code +intro: 'You can enable, configure, and disable {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}.' product: '{% data reusables.gated-features.copilot %}' versions: feature: copilot shortTitle: Visual Studio Code topics: - Copilot -ms.openlocfilehash: 0c91f9c11f98669ba6bcbf84113a629ae6d53044 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147080600' --- -## Acerca de {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %} -Si usas {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_copilot %} puedes autocompletar el código mientras escribes. Después de la instalación, se puede habilitar o deshabilitar {% data variables.product.prodname_copilot %}, y configurar opciones avanzadas en {% data variables.product.prodname_vscode %} o en {% data variables.product.prodname_dotcom_the_website %}. +## About {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %} -## Prerrequisitos +If you use {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_copilot %} can autocomplete code as you type. After installation, you can enable or disable {% data variables.product.prodname_copilot %}, and you can configure advanced settings within {% data variables.product.prodname_vscode %} or on {% data variables.product.prodname_dotcom_the_website %}. -Para configurar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %}, se debe instalar el complemento {% data variables.product.prodname_copilot %}. Para más información, ve "[Introducción a {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %}](/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code)". +## Prerequisites -## Métodos abreviados de teclado para {% data variables.product.prodname_copilot %} +To configure {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you must install the {% data variables.product.prodname_copilot %} plugin. For more information, see "[Getting started with {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}](/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code)." -Puedes usar los métodos abreviados de teclado predeterminados en {% data variables.product.prodname_vscode %} al usar {% data variables.product.prodname_copilot %}. Como alternativa, puedes volver a enlazar los accesos directos en el editor Métodos abreviados de teclado y usar tus preferidos para cada comando específico. Puedes buscar cada método abreviado de teclado por nombre de comando en el editor de Métodos abreviados de teclado. +## Keyboard shortcuts for {% data variables.product.prodname_copilot %} + +You can use the default keyboard shortcuts in {% data variables.product.prodname_vscode %} when using {% data variables.product.prodname_copilot %}. Alternatively, you can rebind the shortcuts in the Keyboard Shortcuts editor using your preferred keyboard shortcuts for each specific command. You can search for each keyboard shortcut by command name in the Keyboard Shortcuts editor. {% mac %} -| Acción | Acceso directo | Nombre de comando | +| Action | Shortcut | Command name | |:---|:---|:---| -|Aceptar una sugerencia insertada|Pestaña|editor.action.inlineSuggest.commit| -|Descartar una sugerencia insertada|Esc|editor.action.inlineSuggest.hide| -|Mostrar la sugerencia insertada siguiente| Opción (⌥)+]
|editor.action.inlineSuggest.showNext| -|Mostrar sugerencia insertada anterior| Opción (⌥)+[
|editor.action.inlineSuggest.showPrevious| -|Desencadenar sugerencia insertada| Opción (⌥)+\
|editor.action.inlineSuggest.trigger| -|Abrir {% data variables.product.prodname_copilot %} (sugerencias adicionales en el panel independiente)|Ctrl+Return|github.copilot.generate| -|Habilitar y deshabilitar {% data variables.product.prodname_copilot %}|_No hay acceso directo predeterminado_|github.copilot.toggleCopilot| +|Accept an inline suggestion|Tab|editor.action.inlineSuggest.commit| +|Dismiss an inline suggestion|Esc|editor.action.inlineSuggest.hide| +|Show next inline suggestion| Option (⌥)+]
|editor.action.inlineSuggest.showNext| +|Show previous inline suggestion| Option (⌥)+[
|editor.action.inlineSuggest.showPrevious| +|Trigger inline suggestion| Option (⌥)+\
|editor.action.inlineSuggest.trigger| +|Open {% data variables.product.prodname_copilot %} (additional suggestions in separate pane)|Ctrl+Return|github.copilot.generate| +|Toggle {% data variables.product.prodname_copilot %} on/off|_No default shortcut_|github.copilot.toggleCopilot| {% endmac %} {% windows %} -| Acción | Acceso directo | Nombre de comando | +| Action | Shortcut | Command name | |:---|:---|:---| -|Aceptar una sugerencia insertada|Pestaña|editor.action.inlineSuggest.commit| -|Descartar una sugerencia insertada|Esc|editor.action.inlineSuggest.hide| -|Mostrar la sugerencia insertada siguiente|Alt+] |editor.action.inlineSuggest.showNext| -|Mostrar sugerencia insertada anterior|Alt+[|editor.action.inlineSuggest.showPrevious| -|Desencadenar sugerencia insertada|Alt+\|editor.action.inlineSuggest.trigger| -|Abrir {% data variables.product.prodname_copilot %} (sugerencias adicionales en el panel independiente)|Ctrl+Entrar|github.copilot.generate| -|Habilitar y deshabilitar {% data variables.product.prodname_copilot %}|_No hay acceso directo predeterminado_|github.copilot.toggleCopilot| +|Accept an inline suggestion|Tab|editor.action.inlineSuggest.commit| +|Dismiss an inline suggestion|Esc|editor.action.inlineSuggest.hide| +|Show next inline suggestion|Alt+] |editor.action.inlineSuggest.showNext| +|Show previous inline suggestion|Alt+[|editor.action.inlineSuggest.showPrevious| +|Trigger inline suggestion|Alt+\|editor.action.inlineSuggest.trigger| +|Open {% data variables.product.prodname_copilot %} (additional suggestions in separate pane)|Ctrl+Enter|github.copilot.generate| +|Toggle {% data variables.product.prodname_copilot %} on/off|_No default shortcut_|github.copilot.toggleCopilot| {% endwindows %} {% linux %} -| Acción | Acceso directo | Nombre de comando | +| Action | Shortcut | Command name | |:---|:---|:---| -|Aceptar una sugerencia insertada|Pestaña|editor.action.inlineSuggest.commit| -|Descartar una sugerencia insertada|Esc|editor.action.inlineSuggest.hide| -|Mostrar la sugerencia insertada siguiente|Alt+] |editor.action.inlineSuggest.showNext| -|Mostrar sugerencia insertada anterior|Alt+[|editor.action.inlineSuggest.showPrevious| -|Desencadenar sugerencia insertada|Alt+\|editor.action.inlineSuggest.trigger| -|Abrir {% data variables.product.prodname_copilot %} (sugerencias adicionales en el panel independiente)|Ctrl+Entrar|github.copilot.generate| -|Habilitar y deshabilitar {% data variables.product.prodname_copilot %}|_No hay acceso directo predeterminado_|github.copilot.toggleCopilot| +|Accept an inline suggestion|Tab|editor.action.inlineSuggest.commit| +|Dismiss an inline suggestion|Esc|editor.action.inlineSuggest.hide| +|Show next inline suggestion|Alt+] |editor.action.inlineSuggest.showNext| +|Show previous inline suggestion|Alt+[|editor.action.inlineSuggest.showPrevious| +|Trigger inline suggestion|Alt+\|editor.action.inlineSuggest.trigger| +|Open {% data variables.product.prodname_copilot %} (additional suggestions in separate pane)|Ctrl+Enter|github.copilot.generate| +|Toggle {% data variables.product.prodname_copilot %} on/off|_No default shortcut_|github.copilot.toggleCopilot| {% endlinux %} -## Reenlazamiento de métodos abreviados de teclado +## Rebinding keyboard shortcuts -Si no quieres usar los métodos abreviados de teclado predeterminados en {% data variables.product.prodname_vscode %} al usar {% data variables.product.prodname_copilot %}, puedes volver a enlazar los métodos abreviados de teclado en el editor Métodos abreviados de teclado mediante tus preferidos para cada comando específico. +If you don't want to use the default keyboard shortcuts in {% data variables.product.prodname_vscode %} when using {% data variables.product.prodname_copilot %}, you can rebind the shortcuts in the Keyboard Shortcuts editor using your preferred keyboard shortcuts for each specific command. -1. Haz clic en el menú **Archivo**, **Preferencias** y, después, **Métodos abreviados de teclado**. -![Captura de pantalla de Métodos abreviados de teclado en Visual Studio Code](/assets/images/help/copilot/vsc-keyboard-shortcuts.png) -1. En el editor "Métodos abreviados de teclado", busca el nombre del comando del método abreviado de teclado que quieres cambiar. -![Captura de pantalla de la barra de búsqueda de Métodos abreviado de teclado](/assets/images/help/copilot/vsc-shortcut-search-bar.png) -1. Junto al comando que quieres cambiar, haz clic en el icono de lápiz. -![Captura de pantalla de Métodos abreviado de teclado](/assets/images/help/copilot/vsc-edit-shortcuts.png) -1. Escribe las pulsaciones de tecla que quieres usar para el comando y presiona Enter/Return. -![Captura de pantalla del cuadro de texto Editar método abreviado de teclado](/assets/images/help/copilot/vsc-edit-shortcuts-textbox.png) +1. Click the **File** menu, click **Preferences**, then click **Keyboard Shortcuts**. +![Screenshot of Visual Studio Code keyboard shortcuts](/assets/images/help/copilot/vsc-keyboard-shortcuts.png) +1. In the "Keyboard Shortcuts" editor, search for the command name of the keyboard shortcut you want to change. +![Screenshot of Keyboard shortcut search bar](/assets/images/help/copilot/vsc-shortcut-search-bar.png) +1. Next to the command you want to change, click the pencil icon. +![Screenshot of Keyboard shortcut editor](/assets/images/help/copilot/vsc-edit-shortcuts.png) +1. Type the keystrokes you want to use for the command, then press Enter/Return. +![Screenshot of Edit keyboard shortcut textbox](/assets/images/help/copilot/vsc-edit-shortcuts-textbox.png) {% data reusables.copilot.enabling-or-disabling-in-vsc %} -## Habilitación o deshabilitación de sugerencias insertadas +## Enabling or disabling inline suggestions -Puedes optar por habilitar o deshabilitar sugerencias insertadas para {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %}. +You can choose to enable or disable inline suggestions for {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}. -1. En el menú **Archivo**, ve a **Preferencias** y haz clic en **Configuración**. -![Captura de pantalla de la configuración de {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/vsc-settings.png) -1. En el panel izquierdo de la pestaña configuración, haz clic en **Extensiones** y, después, selecciona **Copilot**. -1. En "Inline Suggest:Enable", active o anule la selección de la casilla para habilitar o deshabilitar sugerencias insertadas. +{% data reusables.copilot.vscode-settings %} +1. In the left-side panel of the settings tab, click **Extensions** and then select **{% data variables.product.prodname_copilot_short %}**. +1. Under "Inline Suggest:Enable," select or deselect the checkbox to enable or disable inline suggestions. -## Habilitación o deshabilitación de {% data variables.product.prodname_copilot %} para lenguajes específicos +## Enabling or disabling {% data variables.product.prodname_copilot %} for specific languages -Puedes especificar los lenguajes para los que quieres habilitar o deshabilitar {% data variables.product.prodname_copilot %}. +You can specify which languages you want to enable or disable {% data variables.product.prodname_copilot %} for. -1. En {% data variables.product.prodname_vscode %}, haz clic en la pestaña **Extensiones** y,después, ve a la sección **Copilot**. Para más información, ve "[Habilitación y deshabilitación de sugerencias insertadas](#enabling-and-disabling-inline-suggestions)". -1. En "Habilitar o deshabilitar Copilot para lenguajes especificados", haz clic en **Editar en settings.json**. -1. En el archivo _settings.json_, agrega o quita los lenguajes para los que quieres habilitar o deshabilitar {% data variables.product.prodname_copilot %}. Por ejemplo, para habilitar Python en {% data variables.product.prodname_copilot %}, agrega `"python": true` a la lista, asegurándote de que hay una coma final después de todo menos del último elemento de lista. +1. From the {% data variables.product.prodname_vscode %}, click the **Extensions** tab, then navigate to the **Copilot** section. For more information, see "[Enabling and disabling inline suggestions](#enabling-and-disabling-inline-suggestions)." +1. Under "Enable or disable {% data variables.product.prodname_copilot_short %} for specified languages," click **Edit in settings.json**. +1. In the _settings.json_ file, add or remove the languages you want to enable or disable {% data variables.product.prodname_copilot %} for. For example, to enable Python in {% data variables.product.prodname_copilot %}, add `"python": true` to the list, ensuring there is a trailing comma after all but the last list item. ```json { @@ -115,4 +109,22 @@ Puedes especificar los lenguajes para los que quieres habilitar o deshabilitar { } ``` +## Configuring proxy settings for {% data variables.product.prodname_copilot %} + +You can configure {% data variables.product.prodname_copilot %} to connect through an HTTP proxy server in {% data variables.product.prodname_vscode %}. {% data variables.product.prodname_copilot %} supports basic HTTP proxy setups, with or without basic authentication. + +{% data reusables.copilot.vscode-settings %} +1. In the left-side panel of the settings tab, click **Application** and then select **Proxy**. +1. In the textbox under "Proxy", type the address of your proxy server, for example `http://localhost:3128`. Alternatively, {% data variables.product.prodname_copilot %} will use the `http_proxy` and `https_proxy` variables from your environment. + + ![Screenshot of Visual Studio Code proxy textbox](/assets/images/help/copilot/proxy-textbox.png) + +1. Optionally, under "Http: Proxy Authorization", click **Edit in settings.json** and add your required value to send as the `Proxy-Authorization` header for every network request. + + ![Screenshot of Visual Studio Code proxy authorization textbox](/assets/images/help/copilot/proxy-authorization.png) + +1. Optionally, under "Http: Proxy Strict SSL", select or deselect the checkbox to enable or disable strict SSL. + + ![Screenshot of Visual Studio Code proxy strict SSL checkbox](/assets/images/help/copilot/proxy-strict-ssl.png) + {% data reusables.copilot.dotcom-settings %} diff --git a/translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-settings-on-githubcom.md b/translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-settings-on-githubcom.md index 6435e96a31a9..22d15b370255 100644 --- a/translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-settings-on-githubcom.md +++ b/translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-settings-on-githubcom.md @@ -1,7 +1,8 @@ --- -title: "Configuración de los valores de GitHub\_Copilot en GitHub.com" -intro: 'Puedes configurar el comportamiento de {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_dotcom_the_website %}, lo que afecta a cómo funcionan {% data variables.product.prodname_copilot %} en cualquier IDE que uses.' +title: Configuring GitHub Copilot settings on GitHub.com +intro: 'You can configure {% data variables.product.prodname_copilot %}''s behavior on {% data variables.product.prodname_dotcom_the_website %}, which affects how {% data variables.product.prodname_copilot %} functions in any IDE that you use.' product: '{% data reusables.gated-features.copilot %}' +permissions: 'People with individual {% data variables.product.prodname_copilot %} subscriptions can configure their settings on {% data variables.product.prodname_dotcom_the_website %}.' miniTocMaxHeadingLevel: 3 topics: - Copilot @@ -11,15 +12,10 @@ redirect_from: - /github/copilot/about-github-copilot-telemetry - /github/copilot/github-copilot-telemetry-terms shortTitle: GitHub.com -ms.openlocfilehash: cc87328504e3d9eb5e2bce83d981098b7f989ae0 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148109826' --- -## Sobre la configuración de {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_dotcom_the_website %} -Además de la configuración del complemento {% data variables.product.prodname_copilot %} en el IDE compatible, se pueden configurar las opciones de {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_dotcom_the_website %}. La configuración se aplica cada vez que se use {% data variables.product.prodname_copilot %}. +## About {% data variables.product.prodname_copilot %} settings on {% data variables.product.prodname_dotcom_the_website %} + +In addition to the configuration for the {% data variables.product.prodname_copilot %} plugin in your supported IDE, you can configure settings for {% data variables.product.prodname_copilot %} on {% data variables.product.prodname_dotcom_the_website %}. The settings apply wherever you use {% data variables.product.prodname_copilot %}. {% data reusables.copilot.dotcom-settings %} diff --git a/translations/es-ES/content/copilot/configuring-github-copilot/index.md b/translations/es-ES/content/copilot/configuring-github-copilot/index.md index 4817d7b13636..97f00e8a1bd4 100644 --- a/translations/es-ES/content/copilot/configuring-github-copilot/index.md +++ b/translations/es-ES/content/copilot/configuring-github-copilot/index.md @@ -12,6 +12,7 @@ children: - /configuring-github-copilot-in-visual-studio - /configuring-github-copilot-in-a-jetbrains-ide - /configuring-github-copilot-in-neovim + - /configuring-github-copilot-settings-in-your-organization ms.openlocfilehash: e98ac2a1ac8c884776db54e3b8d2a1ea51fbebee ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 ms.translationtype: HT diff --git a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md index 0a0e1b48390e..ae845fc5488b 100644 --- a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md +++ b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md @@ -1,125 +1,125 @@ --- -title: Introducción a GitHub Copilot en IDE de JetBrains +title: Getting started with GitHub Copilot in a JetBrains IDE shortTitle: JetBrains IDE -intro: 'Obtén información sobre cómo instalar {% data variables.product.prodname_copilot %} en IDE de JetBrains y empezar a ver sugerencias a medida que escribes comentarios y código.' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in a JetBrains IDE, and start seeing suggestions as you write comments and code.' product: '{% data reusables.gated-features.copilot %}' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: ae879b5834007a34ab0e3a7a45dcae4c1e31bc4f -ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/29/2022 -ms.locfileid: '148185063' --- + {% data reusables.copilot.copilot-cta-button %} -## Acerca de {% data variables.product.prodname_copilot %} en IDE de JetBrains +## About {% data variables.product.prodname_copilot %} and JetBrains IDEs {% data reusables.copilot.procedural-intro %} -Si usas IDE de JetBrains, puedes ver e incorporar sugerencias de {% data variables.product.prodname_copilot %} directamente en el editor. En esta guía se muestra cómo usar {% data variables.product.prodname_copilot %} en un IDE de JetBrains para macOS, Windows o Linux. +If you use a JetBrains IDE, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within a JetBrains IDE for macOS, Windows, or Linux. + +## Prerequisites -## Requisitos previos +{% data reusables.copilot.subscription-prerequisite %} {% data reusables.copilot.jetbrains-ides %} -## Instalación de la extensión {% data variables.product.prodname_copilot %} en el IDE de JetBrains - -Para usar {% data variables.product.prodname_copilot %} en un IDE de JetBrains, hay que instalar la extensión {% data variables.product.prodname_copilot %}. El siguiente procedimiento te guiará a través de la instalación del complemento {% data variables.product.prodname_copilot %} en IntelliJ IDEA. Los pasos para instalar el complemento en otro IDE compatible pueden diferir. - -1. En el IDE de JetBrains, en el menú **Archivo** para Windows o bajo el nombre del IDE para Mac (por ejemplo, **PyCharm** o **IntelliJ**), haz clic en **Configuración** para Windows o **Preferencias** para Mac. -2. En el menú izquierdo del cuadro de diálogo **Configuración/Preferencias**, haz clic en **Complementos**. -3. En la parte superior del cuadro de diálogo **Configuración/Preferencias**, haz clic en **Marketplace**. En la barra de búsqueda, busca **{% data variables.product.prodname_copilot %}** y haz clic en **Instalar**. - ![Captura de pantalla de la búsqueda de Marketplace](/assets/images/help/copilot/jetbrains-marketplace.png) -1. Después de instalar {% data variables.product.prodname_copilot %}, haz clic en **Reiniciar IDE**. -1. Una vez reiniciado el IDE de JetBrains, haz clic en el menú **Herramientas**. Haz clic en **{% data variables.product.prodname_copilot %}** y, a continuación, haz clic en **Iniciar sesión en {% data variables.product.prodname_dotcom %}** . - ![Captura de pantalla del menú de herramientas de JetBrains](/assets/images/help/copilot/jetbrains-tools-menu.png) -1. En el cuadro de diálogo "Iniciar sesión en {% data variables.product.prodname_dotcom %}", para copiar el código del dispositivo y abrir la ventana de activación del dispositivo, haz clic en **Copiar y abrir**. - ![Captura de pantalla de la copia y apertura del código del dispositivo](/assets/images/help/copilot/device-code-copy-and-open.png) -1. Se abrirá una ventana de activación del dispositivo en el explorador. Pega el código del dispositivo y haz clic en **Continuar**. - - - Para pegar el código en Windows o Linux, presiona Ctrl+v. - - Para pegar el código en macOS, presiona command+v. -1. {% data variables.product.prodname_dotcom %} solicitará los permisos necesarios para {% data variables.product.prodname_copilot %}. Para aprobar estos permisos, haz clic en **Autorizar complemento {% data variables.product.prodname_copilot %}** . -1. Una vez aprobados los permisos, el IDE de JetBrains mostrará una confirmación. Para empezar a usar {% data variables.product.prodname_copilot %}, haz clic en **Aceptar**. - ![Captura de pantalla de la confirmación de permisos del IDE de JetBrains](/assets/images/help/copilot/jetbrains-ide-confirmation.png) +## Installing the {% data variables.product.prodname_copilot %} extension in your JetBrains IDE + +To use {% data variables.product.prodname_copilot %} in a JetBrains IDE, you must install the {% data variables.product.prodname_copilot %} extension. The following procedure will guide you through installation of the {% data variables.product.prodname_copilot %} plugin in IntelliJ IDEA. Steps to install the plugin in another supported IDE may differ. + +1. In your JetBrains IDE, under the **File** menu for Windows or under the name of your IDE for Mac (for example, **PyCharm** or **IntelliJ**), click **Settings** for Windows or **Preferences** for Mac. +2. In the left-side menu of the **Settings/Preferences** dialog box, click **Plugins**. +3. At the top of the **Settings/Preferences** dialog box, click **Marketplace**. In the search bar, search for **{% data variables.product.prodname_copilot %}**, then click **Install**. + ![Screenshot of Marketplace search](/assets/images/help/copilot/jetbrains-marketplace.png) +1. After {% data variables.product.prodname_copilot %} is installed, click **Restart IDE**. +1. After your JetBrains IDE has restarted, click the **Tools** menu. Click **{% data variables.product.prodname_copilot %}**, then click **Login to {% data variables.product.prodname_dotcom %}**. + ![Screenshot of JetBrains tools menu](/assets/images/help/copilot/jetbrains-tools-menu.png) +1. In the "Sign in to {% data variables.product.prodname_dotcom %}" dialog box, to copy the device code and open the device activation window, click **Copy and Open**. + ![Screenshot of device code copy and open](/assets/images/help/copilot/device-code-copy-and-open.png) +1. A device activation window will open in your browser. Paste the device code, then click **Continue**. + + - To paste the code in Windows or Linux, press Ctrl+v. + - To paste the code in macOS, press command+v. +1. {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_copilot %} Plugin**. +1. After the permissions have been approved, your JetBrains IDE will show a confirmation. To begin using {% data variables.product.prodname_copilot %}, click **OK**. + ![Screenshot of JetBrains IDE permissions confirmation](/assets/images/help/copilot/jetbrains-ide-confirmation.png) -## Visualización de tu primera sugerencia +## Seeing your first suggestion {% data reusables.copilot.code-examples-limitations %} -{% data reusables.copilot.supported-languages %} Los ejemplos siguientes están en Java, pero otros lenguajes funcionarán de forma similar. +{% data reusables.copilot.supported-languages %} The following samples are in Java, but other languages will work similarly. {% data reusables.copilot.create-java-file %} -1. En el archivo Java, crea una clase escribiendo `class Test`. - {% data variables.product.prodname_copilot %} sugerirá automáticamente un cuerpo de clase en texto atenuado, como se muestra a continuación. La sugerencia exacta puede variar. - ![Captura de pantalla de la sugerencia del cuerpo de la clase Java](/assets/images/help/copilot/java-class-body-suggestion-jetbrains.png) {% data reusables.copilot.accept-suggestion %} -1. Para pedir a {% data variables.product.prodname_copilot %} que sugiera un cuerpo de función, escriba la siguiente línea debajo del corchete de la función `main`. La sugerencia exacta puede variar. +1. In the Java file, create a class by typing `class Test`. + {% data variables.product.prodname_copilot %} will automatically suggest a class body in grayed text, as shown below. The exact suggestion may vary. + ![Screenshot of the Java class body suggestion](/assets/images/help/copilot/java-class-body-suggestion-jetbrains.png) +{% data reusables.copilot.accept-suggestion %} +1. To prompt {% data variables.product.prodname_copilot %} to suggest a function body, type the following line below the bracket of the `main` function. The exact suggestion may vary. {% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} - ![Captura de pantalla de la sugerencia del cuerpo de la función de Java](/assets/images/help/copilot/java-function-body-suggestion-jetbrains.png) {% data reusables.copilot.accept-suggestion %} + ![Screenshot of the Java function body suggestion](/assets/images/help/copilot/java-function-body-suggestion-jetbrains.png) +{% data reusables.copilot.accept-suggestion %} -{% data variables.product.prodname_copilot %} intentará coincidir con el contexto y el estilo del código. Siempre puede editar el código sugerido. +{% data variables.product.prodname_copilot %} will attempt to match the context and style of your code. You can always edit the suggested code. -## Visualización de sugerencias alternativas +## Seeing alternative suggestions {% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-java-file %} -1. Para solicitar {% data variables.product.prodname_copilot %} para mostrar una sugerencia, escriba la siguiente línea en el archivo Java. -{% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} {% data reusables.copilot.see-alternative-suggestions %} +1. To prompt {% data variables.product.prodname_copilot %} to show you a suggestion, type the following line in the Java file. +{% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} +{% data reusables.copilot.see-alternative-suggestions %} - | SO | Ver la siguiente sugerencia | Ver la sugerencia anterior | + | OS | See next suggestion | See previous suggestion | | :- | :- | :- | - | macOS | Opción+] | Opción+[ | + | macOS | Option+] | Option+[ | | Windows | Alt+] | Alt+[ | | Linux | Alt+] | Alt+[ | {% data reusables.copilot.accept-or-reject-suggestion %} -## Visualización de varias sugerencias en una pestaña nueva +## Seeing multiple suggestions in a new tab {% data reusables.copilot.suggestions-new-tab %} {% data reusables.copilot.create-java-file %} -1. Para solicitar que {% data variables.product.prodname_copilot %} muestre una sugerencia, escribe la siguiente línea en el archivo Java. +1. To prompt {% data variables.product.prodname_copilot %} to show you a suggestion, type the following line in the Java file. {% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} -1. Abre una nueva pestaña con varias sugerencias adicionales. - - En macOS, presiona Comando+Mayús+A y, a continuación, haz clic en **Abrir GitHub Copilot** o presiona Comando+Mayús+\ para abrir la nueva pestaña inmediatamente. - - En Windows o Linux, presiona Ctrl+Entrar y haz clic en **Abrir GitHub Copilot**. - ![Captura de pantalla del diálogo para abrir Copilot](/assets/images/help/copilot/open-copilot-tab-jetbrains.png) -1. Para aceptar una sugerencia, encima de la sugerencia, haz clic en **Aceptar solución**. Si quieres rechazar todas las sugerencias, cierra la pestaña. +1. Open a new tab with multiple additional suggestions. + - On macOS, press Command+Shift+A, then click **Open GitHub Copilot**, or press Command+Shift+\ to open the new tab immediately. + - On Windows or Linux, press Ctrl+Enter, then click **Open GitHub Copilot**. + ![Screenshot of dialogue to open Copilot](/assets/images/help/copilot/open-copilot-tab-jetbrains.png) +1. To accept a suggestion, above the suggestion, click **Accept Solution**. To reject all suggestions, close the tab. -## Generación de sugerencias de código a partir de comentarios +## Generating code suggestions from comments {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-java-file %} -1. Para solicitar que {% data variables.product.prodname_copilot %} sugiera una implementación de una función en el archivo de Java, escribe las líneas siguientes. +1. To prompt {% data variables.product.prodname_copilot %} to suggest an implementation of a function in the Java file, type the following lines. ```java{:copy} // find all images without alternate text // and give them a red border void process () { ``` - ![Captura de pantalla de la sugerencia del cuerpo de la función de Java](/assets/images/help/copilot/comment-suggestion-jetbrains.png) + ![Screenshot of the Java function body suggestion](/assets/images/help/copilot/comment-suggestion-jetbrains.png) -## Habilitación y deshabilitación de {% data variables.product.prodname_copilot %} +## Enabling and disabling {% data variables.product.prodname_copilot %} -Puedes habilitar o deshabilitar {% data variables.product.prodname_copilot %} para todos los lenguajes o para lenguajes individuales. El icono de estado de {% data variables.product.prodname_copilot %} en el panel inferior de la ventana del IDE de JetBrains indica si {% data variables.product.prodname_copilot %} está habilitado o deshabilitado. Cuando está habilitado, el icono está resaltado. Cuando está deshabilitado, el icono está atenuado. +You can enable or disable {% data variables.product.prodname_copilot %} for all languages, or for individual languages. The {% data variables.product.prodname_copilot %} status icon in the bottom panel of your JetBrains IDE window indicates whether {% data variables.product.prodname_copilot %} is enabled or disabled. When enabled, the icon is highlighted. When disabled, the icon is grayed out. -1. Para habilitar o deshabilitar {% data variables.product.prodname_copilot %}, haz clic en el icono de estado en el panel inferior de la ventana JetBrains. - ![Captura de pantalla del icono de estado en IntelliJ IDEA](/assets/images/help/copilot/status-icon-jetbrains.png) -2. Si deshabilitas {% data variables.product.prodname_copilot %}, se te preguntará si quieres deshabilitarlo de forma global o para el lenguaje del archivo que estás editando actualmente. +1. To enable or disable {% data variables.product.prodname_copilot %}, click the status icon in the bottom panel of the JetBrains window. + ![Screenshot of the status icon in IntelliJ IDEA](/assets/images/help/copilot/status-icon-jetbrains.png) +2. If you are disabling {% data variables.product.prodname_copilot %}, you will be asked whether you want to disable it globally, or for the language of the file you are currently editing. - - Para deshabilitar las sugerencias de {% data variables.product.prodname_copilot %} de forma global, haz clic en **Deshabilitar finalizaciones**. - - Para deshabilitar las sugerencias de {% data variables.product.prodname_copilot %} para el lenguaje especificado, haz clic en **Deshabilitar para _LENGUAEE_**. - ![Captura de pantalla de la opción para deshabilitar {% data variables.product.prodname_copilot %} de forma global o para el lenguaje actual](/assets/images/help/copilot/disable-copilot-global-or-langugage-jetbrains.png) + - To disable suggestions from {% data variables.product.prodname_copilot %} globally, click **Disable Completions**. + - To disable suggestions from {% data variables.product.prodname_copilot %} for the specified language, click **Disable Completions for _LANGUAGE_**. + ![Screenshot of option to disable {% data variables.product.prodname_copilot %} globally or for the current language](/assets/images/help/copilot/disable-copilot-global-or-langugage-jetbrains.png) -## Información adicional +## Further reading -- [Sitio web de {% data variables.product.prodname_copilot %}](https://copilot.github.com/) -- [Acerca de {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot#about-the-license-for-the-github-copilot-plugin-in-jetbrains-ides) +- [The {% data variables.product.prodname_copilot %} website](https://copilot.github.com/) +- [About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot#about-the-license-for-the-github-copilot-plugin-in-jetbrains-ides) diff --git a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-neovim.md b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-neovim.md index b838f545d53e..37972765c87c 100644 --- a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-neovim.md +++ b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-neovim.md @@ -1,39 +1,34 @@ --- -title: Introducción a GitHub Copilot en Neovim +title: Getting started with GitHub Copilot in Neovim shortTitle: Neovim product: '{% data reusables.gated-features.copilot %}' -intro: 'Obtén información sobre cómo instalar {% data variables.product.prodname_copilot %} en Neovim y empezar a ver sugerencias a medida que escribes comentarios y código.' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in Neovim, and start seeing suggestions as you write comments and code.' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: 6296ff5b89e86b4b51cbb04bd9ac4ba91863a1ac -ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/29/2022 -ms.locfileid: '148185071' --- + {% data reusables.copilot.copilot-cta-button %} -## Acerca de {% data variables.product.prodname_copilot %} y Neovim +## About {% data variables.product.prodname_copilot %} and Neovim {% data reusables.copilot.procedural-intro %} -Si usas Neovim, puedes ver e incorporar sugerencias de {% data variables.product.prodname_copilot %} directamente en el editor. +If you use a Neovim, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. -## Prerrequisitos +## Prerequisites -- Para usar {% data variables.product.prodname_copilot %} debes tener una suscripción de {% data variables.product.prodname_copilot %}. Para más información, consulta "[Acerca de la facturación de {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)". +{% data reusables.copilot.subscription-prerequisite %} -- Para usar {% data variables.product.prodname_copilot %} en Neovim, debes tener Neovim y la versión 17 o posterior de Node.js instalada. Para obtener más información, consulta la [documentación de Neovim](https://neovim.io/doc/) y el [sitio web de Node.js](https://nodejs.org/en/). +- To use {% data variables.product.prodname_copilot %} in Neovim you must have Neovim and Node.js version 17 or below installed. For more information, see the [Neovim documentation](https://neovim.io/doc/) and the [Node.js website](https://nodejs.org/en/). -## Instalación de la extensión de Neovim +## Installing the Neovim extension {% mac %} {% data reusables.copilot.install-copilot-in-neovim %} - - Para instalar {% data variables.product.prodname_copilot %} con el administrador de complementos integrado de Neovim, escribe el siguiente comando en Terminal. + - To install {% data variables.product.prodname_copilot %} with Neovim's built-in plugin manager, enter the following command in Terminal. git clone https://github.com/github/copilot.vim \ ~/.config/nvim/pack/github/start/copilot.vim @@ -46,7 +41,7 @@ Si usas Neovim, puedes ver e incorporar sugerencias de {% data variables.product {% windows %} {% data reusables.copilot.install-copilot-in-neovim %} - - Para instalar {% data variables.product.prodname_copilot %} con el administrador de complementos integrado de Neovim, escribe el siguiente comando en Git Bash. + - To install {% data variables.product.prodname_copilot %} with Neovim's built-in plugin manager, enter the following command in Git Bash. git clone https://github.com/github/copilot.vim.git ` $HOME/AppData/Local/nvim/pack/github/start/copilot.vim @@ -59,7 +54,7 @@ Si usas Neovim, puedes ver e incorporar sugerencias de {% data variables.product {% linux %} {% data reusables.copilot.install-copilot-in-neovim %} - - Para instalar {% data variables.product.prodname_copilot %} con el administrador de complementos integrado de Neovim, escribe el siguiente comando: + - To install {% data variables.product.prodname_copilot %} with Neovim's built-in plugin manager, enter the following command: git clone https://github.com/github/copilot.vim \ ~/.config/nvim/pack/github/start/copilot.vim @@ -68,14 +63,14 @@ Si usas Neovim, puedes ver e incorporar sugerencias de {% data variables.product {% endlinux %} -## Aprender a usar {% data variables.product.prodname_copilot %} en Neovim +## Learning to use {% data variables.product.prodname_copilot %} in Neovim -Para obtener instrucciones sobre el uso de {% data variables.product.prodname_copilot %} en Neovim, puedes ver la documentación del complemento. Para ver la documentación, abre Neovim y ejecuta el siguiente comando. +For guidance on using {% data variables.product.prodname_copilot %} in Neovim, you can view the plugin documentation. To see the documentation, open Neovim and run the following command. ``` :help copilot ``` -## Información adicional +## Further reading - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) diff --git a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md index a1bdf3a7c93b..d182880e0993 100644 --- a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md +++ b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md @@ -1,109 +1,107 @@ --- -title: "Introducción a GitHub\_Copilot en Visual Studio\_Code" +title: Getting started with GitHub Copilot in Visual Studio Code shortTitle: Visual Studio Code -intro: 'Aprende a instalar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %} y a empezar a ver sugerencias a medida que escribes comentarios y codificas.' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, and start seeing suggestions as you write comments and code.' product: '{% data reusables.gated-features.copilot %}' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: 63c670a7cd5263057f79b7761a960854ecac2dd6 -ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/29/2022 -ms.locfileid: '148185142' --- + {% data reusables.copilot.copilot-cta-button %} -## Acerca de {% data variables.product.prodname_copilot %} y {% data variables.product.prodname_vscode %} +## About {% data variables.product.prodname_copilot %} and {% data variables.product.prodname_vscode %} {% data reusables.copilot.procedural-intro %} -Si usas {% data variables.product.prodname_vscode %}, puedes ver e incorporar sugerencias de {% data variables.product.prodname_copilot %} directamente en el editor. En esta guía, se muestra cómo usar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %} para macOS, Windows o Linux. +If you use {% data variables.product.prodname_vscode %}, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within {% data variables.product.prodname_vscode %} for macOS, Windows, or Linux. + +## Prerequisites -## Prerrequisitos +{% data reusables.copilot.subscription-prerequisite %} -Para usar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %}, debes tener instalado {% data variables.product.prodname_vscode %}. Para más información, consulta la [página de descarga de {% data variables.product.prodname_vscode %}](https://code.visualstudio.com/Download). +- To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you must have {% data variables.product.prodname_vscode %} installed. For more information, see the [{% data variables.product.prodname_vscode %} download page](https://code.visualstudio.com/Download). -## Instalación de la extensión de {% data variables.product.prodname_vscode %} +## Installing the {% data variables.product.prodname_vscode %} extension -Para usar {% data variables.product.prodname_copilot %}, primero debes instalar la extensión de {% data variables.product.prodname_vscode %}. +To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vscode %} extension. -1. En {% data variables.product.prodname_vscode %} Marketplace, ve a la página [Extensión de {% data variables.product.prodname_copilot %}](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) y haz clic en **Instalar**. - ![Instalación de la extensión de {% data variables.product.prodname_copilot %} {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) -1. Aparecerá una ventana emergente que te pedirá que abras {% data variables.product.prodname_vscode %}. Haz clic en **Abrir {% data variables.product.prodname_vscode %}** . -1. En la pestaña "Extensión: {% data variables.product.prodname_copilot %}" de {% data variables.product.prodname_vscode %}, haz clic en **Instalar**. - ![Botón Instalar de {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) -1. Si no autorizaste previamente a {% data variables.product.prodname_vscode %} en tu cuenta de {% data variables.product.prodname_dotcom %}, se te pedirá que inicies sesión en {% data variables.product.prodname_dotcom %} en {% data variables.product.prodname_vscode %}. - - Si autorizaste previamente a {% data variables.product.prodname_vscode %} para tu cuenta en {% data variables.product.prodname_dotcom %}, {% data variables.product.prodname_copilot %} se autorizará automáticamente. - ![Captura de pantalla de la autorización de {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/vsc-copilot-authorize.png) -1. En el explorador, {% data variables.product.prodname_dotcom %} solicitará los permisos necesarios para {% data variables.product.prodname_copilot %}. Para aprobar estos permisos, haz clic en **Autorizar {% data variables.product.prodname_vscode %}** . -1. En {% data variables.product.prodname_vscode %}, en el cuadro de diálogo "{% data variables.product.prodname_vscode %}", haz clic en **Abrir** para confirmar la autenticación. +1. In the {% data variables.product.prodname_vscode %} Marketplace, go to the [{% data variables.product.prodname_copilot %} extension](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) page and click **Install**. + ![Install {% data variables.product.prodname_copilot %} extension {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) +1. A popup will appear, asking to open {% data variables.product.prodname_vscode %}. Click **Open {% data variables.product.prodname_vscode %}**. +1. In the "Extension: {% data variables.product.prodname_copilot %}" tab in {% data variables.product.prodname_vscode %}, click **Install**. + ![Install button in {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) +1. If you have not previously authorized {% data variables.product.prodname_vscode %} in your {% data variables.product.prodname_dotcom %} account, you will be prompted to sign in to {% data variables.product.prodname_dotcom %} in {% data variables.product.prodname_vscode %}. + - If you have previously authorized {% data variables.product.prodname_vscode %} for your account on {% data variables.product.prodname_dotcom %}, {% data variables.product.prodname_copilot %} will be automatically authorized. + ![Screen shot of {% data variables.product.prodname_vscode %} authorization screen](/assets/images/help/copilot/vsc-copilot-authorize.png) +1. In your browser, {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_vscode %}**. +1. In {% data variables.product.prodname_vscode %}, in the "{% data variables.product.prodname_vscode %}" dialog box, to confirm the authentication, click **Open**. -## Visualización de tu primera sugerencia +## Seeing your first suggestion {% data reusables.copilot.code-examples-limitations %} -{% data reusables.copilot.supported-languages %} Los ejemplos siguientes están en JavaScript, pero otros lenguajes funcionarán de manera similar. +{% data reusables.copilot.supported-languages %} The following samples are in JavaScript, but other languages will work similarly. {% data reusables.copilot.create-js-file %} -1. En el archivo de JavaScript, escriba el encabezado de función siguiente. {% data variables.product.prodname_copilot %} sugerirá automáticamente un cuerpo de función completo en texto atenuado, como se muestra a continuación. La sugerencia exacta puede variar. +1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` - ![Captura de pantalla de una primera sugerencia {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) {% data reusables.copilot.accept-suggestion %} + ![Screenshot of a first suggestion {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) +{% data reusables.copilot.accept-suggestion %} -## Visualización de sugerencias alternativas +## Seeing alternative suggestions {% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-js-file %} -1. En el archivo de JavaScript, escriba el encabezado de función siguiente. {% data variables.product.prodname_copilot %} mostrará una sugerencia. +1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will show you a suggestion. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` {% data reusables.copilot.see-alternative-suggestions %} - | SO | Ver la siguiente sugerencia | Ver la sugerencia anterior | + | OS | See next suggestion | See previous suggestion | | :- | :- | :- | - |macOS|Opción (⌥) o Alt+]|Opción (⌥) o Alt+[| + |macOS|Option (⌥) or Alt+]|Option (⌥) or Alt+[| |Windows|Alt+]|Alt+[| |Linux|Alt+]|Alt+[| -1. De manera alternativa, puedes mantener el puntero sobre la sugerencia para ver la paleta de comandos de {% data variables.product.prodname_copilot %} para elegir sugerencias. +1. Alternatively, you can hover over the suggestion to see the {% data variables.product.prodname_copilot %} command palette for choosing suggestions. {% data reusables.copilot.accept-or-reject-suggestion %} -## Visualización de varias sugerencias en una pestaña nueva +## Seeing multiple suggestions in a new tab {% data reusables.copilot.suggestions-new-tab %} {% data reusables.copilot.create-js-file %} -1. En el archivo de JavaScript, escriba el encabezado de función siguiente. {% data variables.product.prodname_copilot %} mostrará una sugerencia. +1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will show you a suggestion. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` -1. Si quieres abrir una pestaña nueva con varias opciones adicionales, presiona Ctrl+Entrar. -1. Si quieres aceptar una sugerencia, haz clic en **Aceptar solución** encima de la sugerencia. Si quieres rechazar todas las sugerencias, cierra la pestaña. +1. To open a new tab with multiple additional options, press Ctrl+Enter. +1. To accept a suggestion, above the suggestion, click **Accept Solution**. To reject all suggestions, close the tab. -## Generación de sugerencias de código a partir de comentarios +## Generating code suggestions from comments {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-js-file %} -1. En el archivo de JavaScript, escribe el comentario siguiente. {% data variables.product.prodname_copilot %} sugerirá una implementación de la función. +1. In the JavaScript file, type the following comment. {% data variables.product.prodname_copilot %} will suggest an implementation of the function. ```javascript{:copy} // find all images without alternate text // and give them a red border function process() { ``` -## Uso de un marco +## Using a framework -También puedes usar {% data variables.product.prodname_copilot %} para generar sugerencias para API y marcos. En el ejemplo siguiente, se usa {% data variables.product.prodname_copilot %} para crear un servidor Express sencillo que devuelve la hora actual. +You can also use {% data variables.product.prodname_copilot %} to generate suggestions for APIs and frameworks. The following example uses {% data variables.product.prodname_copilot %} to create a simple Express server that returns the current time. {% data reusables.copilot.create-js-file %} -1. En el archivo de JavaScript, escribe el comentario siguiente y, luego, presiona Entrar. {% data variables.product.prodname_copilot %} sugerirá una implementación de la aplicación Express. +1. In the JavaScript file, type the following comment and then press Enter. {% data variables.product.prodname_copilot %} will suggest an implementation of the Express app. ```javascript{:copy} // Express server on port 3000 1. To accept each line, press Tab, then Enter. @@ -111,10 +109,10 @@ También puedes usar {% data variables.product.prodname_copilot %} para generar ```javascript{:copy} // Return the current time ``` -1. Para aceptar cada línea, presiona Tab. +1. To accept each line, press Tab. {% data reusables.copilot.enabling-or-disabling-in-vsc %} -## Información adicional +## Further reading - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) diff --git a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md index 5fb19089db96..6716cc522b20 100644 --- a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md +++ b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md @@ -1,86 +1,86 @@ --- -title: "Introducción a GitHub Copilot en Visual\_Studio" +title: Getting started with GitHub Copilot in Visual Studio shortTitle: Visual Studio product: '{% data reusables.gated-features.copilot %}' -intro: 'Obtén información sobre cómo instalar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vs %} y empezar a ver sugerencias a medida que escribe comentarios y código.' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, and start seeing suggestions as you write comments and code.' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: 353095b0b0490cd12da8d853754b524431605819 -ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/29/2022 -ms.locfileid: '148185137' --- + {% data reusables.copilot.copilot-cta-button %} -## Acerca de {% data variables.product.prodname_copilot %} y Visual Studio +## About {% data variables.product.prodname_copilot %} and Visual Studio {% data reusables.copilot.procedural-intro %} -Si usas {% data variables.product.prodname_vs %}, puedes ver e incorporar sugerencias de {% data variables.product.prodname_copilot %} directamente en el editor. En esta guía se muestra cómo usar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vs %} para Windows. +If you use {% data variables.product.prodname_vs %}, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within {% data variables.product.prodname_vs %} for Windows. + +## Prerequisites -## Prerrequisitos +{% data reusables.copilot.subscription-prerequisite %} -Para usar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vs %}, debes tener instalado {% data variables.product.prodname_vs %} 2022 17.2 o posterior. Para más información, consulta la documentación de [Visual Studio IDE](https://visualstudio.microsoft.com/vs/). +- To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, you must have {% data variables.product.prodname_vs %} 2022 17.2 or later installed. For more information, see the [Visual Studio IDE](https://visualstudio.microsoft.com/vs/) documentation. {% note %} -**Nota**: {% data variables.product.prodname_copilot %} no está disponible actualmente para su uso con Visual Studio para Mac. +**Note**: {% data variables.product.prodname_copilot %} is not currently available for use with Visual Studio for Mac. {% endnote %} -## Instalación de la extensión {% data variables.product.prodname_vs %} +## Installing the {% data variables.product.prodname_vs %} extension -Para usar {% data variables.product.prodname_copilot %}, primero debes instalar la extensión {% data variables.product.prodname_vs %}. -1. En la barra de herramientas de Visual Studio, haz clic en **Extensiones** y, a continuación, haz clic en **Administrar extensiones**. - ![Captura de pantalla de la barra de herramientas de Visual Studio](/assets/images/help/copilot/visual-studio-toolbar.png) -1. En la ventana "Administrar extensiones", haz clic en **Visual Studio Marketplace**, busca la extensión {% data variables.product.prodname_copilot %} y haz clic en **Descargar**. - ![Captura de pantalla de la extensión GitHub Copilot para Visual Studio con el botón Descargar resaltado](/assets/images/help/copilot/install-copilot-extension-visual-studio.png) -1. Cierra la ventana "Administrar extensiones" y, a continuación, cierra y vuelve a iniciar {% data variables.product.prodname_vs %}. -1. Opcionalmente, para comprobar que {% data variables.product.prodname_copilot %} está instalado y habilitado, vuelve a **Administrar extensiones**, haz clic en **Instalado** para ver las extensiones instaladas actualmente y, a continuación, haz clic en **{% data variables.product.prodname_copilot %}** para ver la información de estado. - ![Captura de pantalla de las extensiones instaladas en Visual Studio con GitHub Copilot resaltado](/assets/images/help/copilot/installed-copilot-extension-visual-studio.png) -1. Abre o crea un proyecto en {% data variables.product.prodname_vs %}. -1. En el cuadro de diálogo "Microsoft {% data variables.product.prodname_vs %}", para copiar el código de activación del dispositivo, haz clic en **Aceptar**. - ![Captura de pantalla del cuadro de diálogo Microsoft {% data variables.product.prodname_vs %}](/assets/images/help/copilot/vs-auth-dialogue.png) -1. Se abrirá una ventana de activación del dispositivo en el explorador. Pega el código del dispositivo y haz clic en **Continuar**. +To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vs %} extension. +1. In the Visual Studio toolbar, click **Extensions**, then click **Manage Extensions**. + ![Screenshot of the Visual Studio toolbar](/assets/images/help/copilot/visual-studio-toolbar.png) +1. In the "Manage Extensions" window, click **Visual Studio Marketplace**, search for the {% data variables.product.prodname_copilot %} extension, then click **Download**. + ![Screenshot of GitHub Copilot extension for Visual Studio with the download button emphasized](/assets/images/help/copilot/install-copilot-extension-visual-studio.png) +1. Close the "Manage Extensions" window, then exit and relaunch {% data variables.product.prodname_vs %}. +1. Optionally, to check that {% data variables.product.prodname_copilot %} is installed and enabled, go back to **Manage Extensions**, click **Installed** to view your currently installed extensions, then click **{% data variables.product.prodname_copilot %}** to see status information. + ![Screenshot of installed extensions in Visual Studio with GitHub Copilot emphasized](/assets/images/help/copilot/installed-copilot-extension-visual-studio.png) +1. Open or create a new project in {% data variables.product.prodname_vs %}. +1. In the "Microsoft {% data variables.product.prodname_vs %}" dialog box, to copy your device activation code, click **OK**. + ![Screenshot of the Microsoft {% data variables.product.prodname_vs %} dialogue box](/assets/images/help/copilot/vs-auth-dialogue.png) +1. A device activation window will open in your browser. Paste the device code, then click **Continue**. - - Para pegar el código en Windows o Linux, presiona Ctrl+v. - - Para pegar el código en macOS, presiona command+v. -1. {% data variables.product.prodname_dotcom %} solicitará los permisos necesarios para {% data variables.product.prodname_copilot %}. Para aprobar estos permisos, haz clic en **Autorizar complemento {% data variables.product.prodname_copilot %}** . -1. Después de aprobar los permisos, {% data variables.product.prodname_vs %} mostrará una confirmación. - ![Captura de pantalla de la confirmación de permisos de {% data variables.product.prodname_vs %}](/assets/images/help/copilot/vs-confirmation.png) + - To paste the code in Windows or Linux, press Ctrl+v. + - To paste the code in macOS, press command+v. +1. {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_copilot %} Plugin**. +1. After you approve the permissions, {% data variables.product.prodname_vs %} will show a confirmation. + ![Screenshot of {% data variables.product.prodname_vs %} permissions confirmation](/assets/images/help/copilot/vs-confirmation.png) -## Visualización de tu primera sugerencia +## Seeing your first suggestion -{% data reusables.copilot.code-examples-limitations %} {% data reusables.copilot.supported-languages %} Los ejemplos siguientes están en C#, pero otros lenguajes funcionarán de forma similar. +{% data reusables.copilot.code-examples-limitations %} +{% data reusables.copilot.supported-languages %} The following samples are in C#, but other languages will work similarly. {% data reusables.copilot.create-c-file %} -1. En el archivo de C#, escribe la siguiente signatura de función. {% data variables.product.prodname_copilot %} sugerirá automáticamente un cuerpo de función completo en texto atenuado, como se muestra a continuación. La sugerencia exacta puede variar. +1. In the C# file, type the following function signature. {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. ```csharp{:copy} int CalculateDaysBetweenDates( ``` - ![Captura de pantalla de una primera sugerencia de Visual Studio Code](/assets/images/help/copilot/first-suggestion-visual-studio.png) {% data reusables.copilot.accept-suggestion %} + ![Screenshot of a first suggestion Visual Studio Code](/assets/images/help/copilot/first-suggestion-visual-studio.png) +{% data reusables.copilot.accept-suggestion %} -## Visualización de sugerencias alternativas -{% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-c-file %} -1. En el archivo de C#, escribe la siguiente signatura de función. {% data variables.product.prodname_copilot %} mostrará una sugerencia. +## Seeing alternative suggestions +{% data reusables.copilot.alternative-suggestions %} +{% data reusables.copilot.create-c-file %} +1. In the C# file, type the following function signature. {% data variables.product.prodname_copilot %} will show you a suggestion. ```csharp{:copy} int CalculateDaysBetweenDates( ``` -1. Si hay sugerencias alternativas disponibles, puedes ver estas alternativas presionando Alt+] (o Alt+[). -1. Opcionalmente, puedes mantener el puntero sobre la sugerencia para ver la paleta de comandos{% data variables.product.prodname_copilot %} para elegir sugerencias. +1. If alternative suggestions are available, you can see these alternatives by pressing Alt+] (or Alt+[). +1. Optionally, you can hover over the suggestion to see the {% data variables.product.prodname_copilot %} command palette for choosing suggestions. {% data reusables.copilot.accept-or-reject-suggestion %} -## Generación de sugerencias de código a partir de comentarios +## Generating code suggestions from comments {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-c-file %} -1. En el archivo de C#, escribe el comentario siguiente. {% data variables.product.prodname_copilot %} sugerirá una implementación de la función. +1. In the C# file, type the following comment. {% data variables.product.prodname_copilot %} will suggest an implementation of the function. ```csharp{:copy} using System.Xml.Linq; @@ -93,6 +93,6 @@ Para usar {% data variables.product.prodname_copilot %}, primero debes instalar {% data reusables.copilot.enabling-or-disabling-vs %} -## Información adicional +## Further reading - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) diff --git a/translations/es-ES/content/copilot/overview-of-github-copilot/about-github-copilot.md b/translations/es-ES/content/copilot/overview-of-github-copilot/about-github-copilot.md index 688f2c32da6c..4bfef6012c20 100644 --- a/translations/es-ES/content/copilot/overview-of-github-copilot/about-github-copilot.md +++ b/translations/es-ES/content/copilot/overview-of-github-copilot/about-github-copilot.md @@ -1,46 +1,42 @@ --- -title: "Acerca de GitHub\_Copilot" -intro: '{% data variables.product.prodname_copilot %} puede ayudarte a codificar ofreciendo sugerencias de estilo autocompletar. Puedes aprender qué se debe tener en cuenta al usar {% data variables.product.prodname_copilot %} y cómo funcionan los datos {% data variables.product.prodname_copilot %}.' +title: About GitHub Copilot +intro: '{% data variables.product.prodname_copilot %} can help you code by offering autocomplete-style suggestions. You can learn how {% data variables.product.prodname_copilot %} works, and what to consider while using {% data variables.product.prodname_copilot %}.' versions: feature: copilot topics: - Copilot shortTitle: About GitHub Copilot -ms.openlocfilehash: dd4538cb4cf6fc9dd84bb3f0d05bf8a85559d5ec -ms.sourcegitcommit: d82f268a6f0236d1f4d2bf3d049974ada0170402 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/10/2022 -ms.locfileid: '148160644' --- -## Acerca de {% data variables.product.prodname_copilot %} -{% data variables.product.prodname_copilot %} es un programador de pares de IA que ofrece sugerencias de estilo autocompletar a medida que programas. Puedes recibir sugerencias de {% data variables.product.prodname_copilot %} ya sea empezando a escribir el código que quieres usar o escribiendo un comentario de lenguaje natural que describa lo que quieres que haga el código. {% data variables.product.prodname_copilot %} analiza el contexto del archivo que estás editando, así como los archivos relacionados, y ofrece sugerencias desde el editor de texto. {% data variables.product.prodname_copilot %} cuenta con la tecnología de OpenAI Codex, un nuevo sistema de inteligencia artificial creado por OpenAI. +## About {% data variables.product.prodname_copilot %} -{% data variables.product.prodname_copilot %} se entrena en todos los idiomas que aparecen en repositorios públicos. Para cada idioma, la calidad de las sugerencias que reciba puede depender del volumen y la diversidad de datos de entrenamiento para ese idioma. Por ejemplo, JavaScript está bien representado en repositorios públicos y es uno de los mejores lenguajes admitidos de {% data variables.product.prodname_copilot %}. Los lenguajes con menos representación en repositorios públicos pueden producir menos sugerencias o menos sólidas. +{% data variables.product.prodname_copilot %} is an AI pair programmer that offers autocomplete-style suggestions as you code. You can receive suggestions from {% data variables.product.prodname_copilot %} either by starting to write the code you want to use, or by writing a natural language comment describing what you want the code to do. {% data variables.product.prodname_copilot %} analyzes the context in the file you are editing, as well as related files, and offers suggestions from within your text editor. {% data variables.product.prodname_copilot %} is powered by OpenAI Codex, a new AI system created by OpenAI. -{% data variables.product.prodname_copilot %} está disponible como extensión en Visual Studio Code, Visual Studio, Neovim y el conjunto de IDE de JetBrains. Para más información, ve "[Introducción a {% data variables.product.prodname_copilot %}](/copilot/getting-started-with-github-copilot)". +{% data variables.product.prodname_copilot %} is trained on all languages that appear in public repositories. For each language, the quality of suggestions you receive may depend on the volume and diversity of training data for that language. For example, JavaScript is well-represented in public repositories and is one of {% data variables.product.prodname_copilot %}'s best supported languages. Languages with less representation in public repositories may produce fewer or less robust suggestions. -## Uso de {% data variables.product.prodname_copilot %} +{% data variables.product.prodname_copilot %} is available as an extension in Visual Studio Code, Visual Studio, Neovim and the JetBrains suite of IDEs. For more information, see "[Getting started with {% data variables.product.prodname_copilot %}](/copilot/getting-started-with-github-copilot)." -Puedes ver ejemplos reales de {% data variables.product.prodname_copilot %} en acción. Para más información, ve el sitio web de [{% data variables.product.prodname_copilot %}](https://copilot.github.com/). +## Using {% data variables.product.prodname_copilot %} -GitHub Copilot ofrece sugerencias de un modelo que OpenAI creó a partir de miles de millones de líneas de código abierto. Como resultado, el conjunto de entrenamiento para {% data variables.product.prodname_copilot %} puede contener patrones de codificación no seguros, errores o referencias a API o expresiones obsoletas. Cuando {% data variables.product.prodname_copilot %} genera sugerencias basadas en estos datos de entrenamiento, esas sugerencias también pueden contener patrones no deseados. +You can see real-world examples of {% data variables.product.prodname_copilot %} in action. For more information, see the [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) website. -Eres responsable de garantizar la seguridad y la calidad del código. Se recomienda tomar las mismas precauciones al usar el código generado por {% data variables.product.prodname_copilot %} que tomaría al usar cualquier código que no hayas escrito. Estas precauciones incluyen pruebas rigurosas, examen de IP y seguimiento de vulnerabilidades de seguridad. {% data variables.product.company_short %} proporciona una serie de características para ayudarte a supervisar y mejorar la calidad del código, como {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dependabot %}, {% data variables.product.prodname_codeql %} y {% data variables.product.prodname_code_scanning %}. Todas estas características son gratuitas para su uso en repositorios públicos. Para más información, ve "[Descripción de {% data variables.product.prodname_actions %}](/actions/learn-github-actions/understanding-github-actions)" y "[Características de seguridad de {% data variables.product.company_short %}](/code-security/getting-started/github-security-features)". +{% data variables.product.prodname_copilot %} offers suggestions from a model that OpenAI built from billions of lines of open source code. As a result, the training set for {% data variables.product.prodname_copilot %} may contain insecure coding patterns, bugs, or references to outdated APIs or idioms. When {% data variables.product.prodname_copilot %} produces suggestions based on this training data, those suggestions may also contain undesirable patterns. -{% data variables.product.prodname_copilot %} usa filtros para bloquear palabras ofensivas en las indicaciones y evitar generar sugerencias en contextos confidenciales. Estamos comprometidos a mejorar constantemente el sistema de filtros para detectar y quitar sugerencias ofensivas generadas por {% data variables.product.prodname_copilot %}, incluidas las salidas sesgadas, discriminatorias o abusivas. Si ves una sugerencia ofensiva generada por {% data variables.product.prodname_copilot %}, notifícalo directamente a copilot-safety@github.com para que podamos mejorar nuestras medidas de seguridad. +You are responsible for ensuring the security and quality of your code. We recommend you take the same precautions when using code generated by {% data variables.product.prodname_copilot %} that you would when using any code you didn't write yourself. These precautions include rigorous testing, IP scanning, and tracking for security vulnerabilities. {% data variables.product.company_short %} provides a number of features to help you monitor and improve code quality, such as {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dependabot %}, {% data variables.product.prodname_codeql %} and {% data variables.product.prodname_code_scanning %}. All these features are free to use in public repositories. For more information, see "[Understanding {% data variables.product.prodname_actions %}](/actions/learn-github-actions/understanding-github-actions)" and "[{% data variables.product.company_short %} security features](/code-security/getting-started/github-security-features)." -{% data reusables.copilot.emus-cannot-use-copilot %} +{% data variables.product.prodname_copilot %} uses filters to block offensive words in the prompts and avoid producing suggestions in sensitive contexts. We are committed to constantly improving the filter system to more intelligently detect and remove offensive suggestions generated by {% data variables.product.prodname_copilot %}, including biased, discriminatory, or abusive outputs. If you see an offensive suggestion generated by {% data variables.product.prodname_copilot %}, please report the suggestion directly to copilot-safety@github.com so that we can improve our safeguards. -## Acerca de la facturación para {% data variables.product.prodname_copilot %} +## About billing for {% data variables.product.prodname_copilot %} -{% data variables.product.prodname_copilot %} es una característica de pago que requiere una suscripción mensual o anual. Los alumnos, profesores y mantenedores verificados de proyectos de código abierto populares en {% data variables.product.prodname_dotcom %} pueden usar {% data variables.product.prodname_copilot %} de forma gratuita. Si cumples los criterios para una suscripción gratuita de {% data variables.product.prodname_copilot %}, se te notificará de forma automática cuando visites la página de suscripción de {% data variables.product.prodname_copilot %}. Si no cumples los criterios para una suscripción gratuita de {% data variables.product.prodname_copilot %}, se te ofrecerá una prueba de 60 días, después de la cual se requiere una suscripción de pago para su uso continuado. Para más información, consulta "[Acerca de la facturación de {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)". +{% data variables.product.prodname_copilot %} is a paid feature, requiring a monthly or yearly subscription. {% data variables.product.prodname_copilot %} subscriptions can be paid for and managed through a personal account on {% data variables.product.prodname_dotcom_the_website %} with {% data variables.product.prodname_copilot_for_individuals %}, or paid for and managed centrally through an enterprise account on {% data variables.product.prodname_ghe_cloud %} with {% data variables.product.prodname_copilot_for_business %}. -## Sobre la licencia del complemento {% data variables.product.prodname_copilot %} en los IDE de JetBrains +Verified students, teachers, and maintainers of popular open source projects on {% data variables.product.prodname_dotcom %} are eligible to use {% data variables.product.prodname_copilot_individuals_short %} for free. If you meet the criteria for a free {% data variables.product.prodname_copilot_individuals_short %} subscription, you will be automatically notified when you visit the {% data variables.product.prodname_copilot %} subscription page. If you do not meet the criteria for a free {% data variables.product.prodname_copilot_individuals_short %} subscription, you will be offered a 60-day free trial, after which a paid subscription is required for continued use. {% data variables.product.prodname_copilot_for_business %} does not include a free trial. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)." -{% data variables.product.prodname_dotcom %}, Inc. es el licenciante del complemento JetBrains. El contrato de licencia de usuario final para este complemento es los [{% data variables.product.prodname_dotcom %} Condiciones de GitHub para las características y productos adicionales](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot) y el uso de este complemento está sujeto a esos términos. JetBrains no tiene ninguna responsabilidad ni obligación en relación con el complemento o con dicho contrato. Al usar el complemento, se aceptan los términos anteriores. +## About the license for the {% data variables.product.prodname_copilot %} plugin in JetBrains IDEs -## Información adicional +{% data variables.product.prodname_dotcom %}, Inc. is the licensor of the JetBrains plugin. The end user license agreement for this plugin is the [{% data variables.product.prodname_dotcom %} Terms for Additional Products and Features](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot) and use of this plugin is subject to those terms. JetBrains has no responsibility or liability in connection with the plugin or such agreement. By using the plugin, you agree to the foregoing terms. -- "[{% data variables.product.company_short %} Condiciones de GitHub para las características y productos adicionales](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)" +## Further reading + +- "[{% data variables.product.company_short %} Terms for Additional Products and Features](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)"{% ifversion ghec %} +- "[{% data variables.product.prodname_copilot_for_business %} Privacy Statement](/free-pro-team@latest/site-policy/privacy-policies/github-copilot-for-business-privacy-statement)"{% endif %} diff --git a/translations/es-ES/content/copilot/quickstart.md b/translations/es-ES/content/copilot/quickstart.md index bde85097a606..c4760f5bb2a0 100644 --- a/translations/es-ES/content/copilot/quickstart.md +++ b/translations/es-ES/content/copilot/quickstart.md @@ -14,7 +14,7 @@ topics: {% data variables.product.prodname_copilot %} is an AI pair programmer. You can use {% data variables.product.prodname_copilot %} to get suggestions for whole lines or entire functions right inside your editor. -This guide will show you how to sign up for {% data variables.product.prodname_copilot %}, install the {% data variables.product.prodname_copilot %} extension in {% data variables.product.prodname_vscode %}, and get your first suggestion. For more information on {% data variables.product.prodname_copilot %}, see "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." For more in-depth information on how to use {% data variables.product.prodname_copilot %} in a variety of environments, see "[Getting Started](/copilot/getting-started-with-github-copilot)." +This guide will show you how to sign up for {% data variables.product.prodname_copilot %} through your personal account, install the {% data variables.product.prodname_copilot %} extension in {% data variables.product.prodname_vscode %}, and get your first suggestion. For more information on {% data variables.product.prodname_copilot %}, see "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." For more in-depth information on how to use {% data variables.product.prodname_copilot %} in a variety of environments, see "[Getting Started](/copilot/getting-started-with-github-copilot)." ## Prerequisites @@ -23,6 +23,14 @@ This guide will show you how to sign up for {% data variables.product.prodname_c ## Signing up for {% data variables.product.prodname_copilot %} +Before you can start using {% data variables.product.prodname_copilot %}, you will need to set up a free trial or subscription for your personal account. + +{% note %} + +**Note:** If you are a member of an organization owned by a {% data variables.product.prodname_ghe_cloud %} account with a {% data variables.product.prodname_copilot %} subscription, and you have been assigned a {% data variables.product.prodname_copilot %} seat by your organization, you can proceed to "[Installing the {% data variables.product.prodname_copilot %} extension for {% data variables.product.prodname_vscode %}](/copilot/quickstart#installing-the-github-copilot-extension-for-visual-studio-code)." + +{% endnote %} + {% data reusables.copilot.signup-procedure %} ## Installing the {% data variables.product.prodname_copilot %} extension for {% data variables.product.prodname_vscode %} diff --git a/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md b/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md index 66534676dda8..a712697a63e9 100644 --- a/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md +++ b/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md @@ -1,6 +1,6 @@ --- -title: Acerca del campus global de GitHub para alumnos -intro: '{% data variables.product.prodname_education %} le ofrece a los estudiantes experiencia práctica con acceso gratuito a diversas herramientas de programadores de los socios de {% data variables.product.prodname_dotcom %}.' +title: About GitHub Global Campus for students +intro: '{% data variables.product.prodname_education %} offers students real-world experience with free access to various developer tools from {% data variables.product.prodname_dotcom %}''s partners.' redirect_from: - /education/teach-and-learn-with-github-education/about-github-education-for-students - /github/teaching-and-learning-with-github-education/about-github-education-for-students @@ -10,46 +10,40 @@ redirect_from: versions: fpt: '*' shortTitle: For students -ms.openlocfilehash: 198f0354e63721a4763e8fa32f832a19b2dac9d9 -ms.sourcegitcommit: 3abdbdbb47a9319f20e11845e9c2d8a7fce63422 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/15/2022 -ms.locfileid: '148165101' --- -Usar {% data variables.product.prodname_dotcom %} para tus proyectos escolares es un modo práctico de colaborar con otros y crear un portfolio que exhiba experiencia práctica. +Using {% data variables.product.prodname_dotcom %} for your school projects is a practical way to collaborate with others and build a portfolio that showcases real-world experience. -Cualquiera con una cuenta de {% data variables.product.prodname_dotcom %} puede colaborar en repositorios públicos y privados ilimitados con {% data variables.product.prodname_free_user %}. Como alumno, también puedes solicitar los beneficios de {% data variables.product.prodname_education %} para los alumnos. Los beneficios y recursos para los alumnos de {% data variables.product.prodname_education %} se incluyen en el {% data variables.product.prodname_global_campus %}, un portal que te permite acceder a sus beneficios educativos, todo en un solo lugar. Para obtener más información, consulta «[Solicitar acceso al campus global de GitHub como alumno](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/apply-to-github-global-campus-as-a-student)» y [{% data variables.product.prodname_education %}](https://education.github.com/). +Everyone with a {% data variables.product.prodname_dotcom %} account can collaborate in unlimited public and private repositories with {% data variables.product.prodname_free_user %}. As a student, you can also apply for {% data variables.product.prodname_education %} student benefits. Your {% data variables.product.prodname_education %} student benefits and resources are all included in {% data variables.product.prodname_global_campus %}, a portal that allows you to access your education benefits, all in one place. For more information, see "[Apply to GitHub Global Campus as a student](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/apply-to-github-global-campus-as-a-student)" and [{% data variables.product.prodname_education %}](https://education.github.com/). -Antes de solicitar un descuento individual, comprueba si la comunidad de aprendizaje ya está asociada con nosotros como una escuela del {% data variables.product.prodname_campus_program %}. Para más información, vea "[Acerca de {% data variables.product.prodname_campus_program %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-github-campus-program)". +Before applying for Global Campus, check if your learning community is already partnered with us as a {% data variables.product.prodname_campus_program %} school. For more information, see "[About {% data variables.product.prodname_campus_program %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-github-campus-program)." -Si eres miembro de un club de la escuela, un profesor puede solicitar acceso al {% data variables.product.prodname_global_campus %} para que tu equipo pueda colaborar con {% data variables.product.prodname_team %}, lo que permite repositorios privados y usuarios ilimitados de forma gratuita. Para obtener más información, consulta «[Solicitar acceso al {% data variables.product.prodname_global_campus %} como profesor](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)». +If you're a member of a school club, a teacher can apply for {% data variables.product.prodname_global_campus %} so your team can collaborate using {% data variables.product.prodname_team %}, which allows unlimited users and private repositories, for free. For more information, see "[Apply to {% data variables.product.prodname_global_campus %} as a teacher](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)." -Una vez que se seas un alumno verificado del {% data variables.product.prodname_global_campus %}, puedes acceder al {% data variables.product.prodname_global_campus %} en cualquier momento yendo al [sitio web de {% data variables.product.prodname_education %}](https://education.github.com). +Once you are a verified {% data variables.product.prodname_global_campus %} student, you can access {% data variables.product.prodname_global_campus %} anytime by going to the [{% data variables.product.prodname_education %} website](https://education.github.com). -![Portal del {% data variables.product.prodname_global_campus %} para los alumnos](/assets/images/help/education/global-campus-portal-students.png) +![{% data variables.product.prodname_global_campus %} portal for students](/assets/images/help/education/global-campus-portal-students.png) -## Características del {% data variables.product.prodname_global_campus %} para los alumnos +## {% data variables.product.prodname_global_campus %} features for students -{% data variables.product.prodname_global_campus %} es un portal desde el que puedes acceder a tus ventajas y a los recursos de {% data variables.product.prodname_education %}, todo en un solo lugar. En el portal del {% data variables.product.prodname_global_campus %}, los alumnos pueden: -- Conectarse con un experto local del campus. Para obtener más información sobre los expertos del campus, consulta «[Acerca de los expertos del campus](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-at-your-educational-institution/about-campus-experts)». -- Explorar y reclamar ofertas para herramientas del sector gratuitas en el [Paquete para desarrolladores para los alumnos](https://education.github.com/pack). -- Consultar los próximos eventos en persona y virtuales para los alumnos, mantenidos por {% data variables.product.prodname_education %} y por los líderes del alumnado. -- Consultar las asignaciones del [Aula de GitHub](https://classroom.github.com/) con las próximas fechas de vencimiento. -- Mantenerte al corriente de lo que interesa a la comunidad con los episodios recientes de [Campus TV](https://www.twitch.tv/githubeducation). Campus TV está creado por {% data variables.product.prodname_dotcom %} y por los líderes de la comunidad de alumnos y se puede ver en vivo o a petición. -- Descubrir los repositorios creados por alumnos desde GitHub Community Exchange. Para obtener más información, consulta «[Acerca de GitHub Community Exchange](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)». +{% data variables.product.prodname_global_campus %} is a portal from which you can access your {% data variables.product.prodname_education %} benefits and resources, all in one place. On the {% data variables.product.prodname_global_campus %} portal, students can: +- Connect with a local Campus Expert. For more information on campus experts, see "[About Campus Experts](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-at-your-educational-institution/about-campus-experts)." +- Explore and claim offers for free industry tools from the [Student Developer Pack](https://education.github.com/pack). +- See upcoming in-person and virtual events for students, curated by {% data variables.product.prodname_education %} and student leaders. +- View assignments from [GitHub Classroom](https://classroom.github.com/) with upcoming due dates. +- Stay in the know on what the community is interested in by rewatching recent [Campus TV](https://www.twitch.tv/githubeducation) episodes. Campus TV is created by {% data variables.product.prodname_dotcom %} and student community leaders and can be watched live or on demand. +- Discover student-created repositories from GitHub Community Exchange. For more information, see "[About GitHub Community Exchange](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)." -Los alumnos de {% data variables.product.prodname_global_campus %} también reciben las siguientes ventajas de {% data variables.product.prodname_dotcom %}. -- **{% data variables.product.prodname_copilot %}** : Los alumnos verificados reciben una suscripción gratuita de {% data variables.product.prodname_copilot %}. Recibirás una notificación automática sobre la suscripción gratuita cuando visites la página de suscripción de {% data variables.product.prodname_copilot %} en la configuración de la cuenta. Para obtener más información sobre la suscripción a {% data variables.product.prodname_copilot %} y su uso, consulta "[Administración de la suscripción de {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)" y "[Acerca de {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)". -- **{% data variables.product.prodname_github_codespaces %}** : {% data reusables.education.student-codespaces-benefit %} Para obtener más información sobre cómo empezar a trabajar con {% data variables.product.prodname_github_codespaces %}, consulta "[Introducción a {% data variables.product.prodname_github_codespaces %}](/codespaces/overview)". +{% data variables.product.prodname_global_campus %} students also receive the following {% data variables.product.prodname_dotcom %} benefits. +- **{% data variables.product.prodname_copilot %}**: Verified students receive a free subscription for {% data variables.product.prodname_copilot %}. You will be automatically notified about the free subscription when you visit the {% data variables.product.prodname_copilot %} subscription page in your account settings. For more information about subscribing to and using {% data variables.product.prodname_copilot %}, see "[Managing your {% data variables.product.prodname_copilot_for_individuals %} subscription](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-for-individuals-subscription#setting-up-a-trial-of-github-copilot)" and "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." +- **{% data variables.product.prodname_github_codespaces %}**: {% data reusables.education.student-codespaces-benefit %} For more information on getting started with {% data variables.product.prodname_github_codespaces %}, see "[{% data variables.product.prodname_github_codespaces %} overview](/codespaces/overview)." {% note %} -**Nota:** {% data reusables.education.note-on-student-codespaces-usage %} Para obtener más información, consulta "[Uso de {% data variables.product.prodname_github_codespaces %} con {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom)". +**Note:** {% data reusables.education.note-on-student-codespaces-usage %} For more information, see "[Using {% data variables.product.prodname_github_codespaces %} with {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom)." {% endnote %} -## Información adicional +## Further reading -- «[Acerca del {% data variables.product.prodname_global_campus %} para profesores](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers)» -- "[Acerca de {% data variables.product.prodname_community_exchange %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)" +- "[About {% data variables.product.prodname_global_campus %} for teachers](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers)" +- "[About {% data variables.product.prodname_community_exchange %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)" diff --git a/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md b/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md index b16c6517d2c1..54d02697ce93 100644 --- a/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md +++ b/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md @@ -1,6 +1,6 @@ --- -title: Acerca del campus global de GitHub para alumnos -intro: '{% data variables.product.prodname_global_campus %} ofrece a los profesores un lugar central para acceder a herramientas y recursos para trabajar de forma más eficaz dentro y fuera del aula.' +title: About GitHub Global Campus for teachers +intro: '{% data variables.product.prodname_global_campus %} offers teachers a central place to access tools and resources for working more effectively inside and outside of the classroom.' redirect_from: - /education/teach-and-learn-with-github-education/about-github-education-for-educators-and-researchers - /github/teaching-and-learning-with-github-education/about-github-education-for-educators-and-researchers @@ -10,32 +10,28 @@ redirect_from: versions: fpt: '*' shortTitle: For teachers -ms.openlocfilehash: 2a93f87df67d1694bd93888d29a582afa9c749e4 -ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/09/2022 -ms.locfileid: '148158969' --- -Como alumno o miembro del profesorado en una institución educativa acreditada, puedes solicitar acceso al {% data variables.product.prodname_global_campus %}, que incluye acceso a las ventajas y los recursos de {% data variables.product.prodname_education %}. Para obtener más información, consulta «[Solicitar acceso al {% data variables.product.prodname_global_campus %} como profesor](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)». -{% data variables.product.prodname_global_campus %} es un portal que permite a la comunidad educativa de GitHub acceder a las ventajas de educación, y todo en un solo lugar. Una vez que se seas un profesor verificado del {% data variables.product.prodname_global_campus %}, puedes acceder al {% data variables.product.prodname_global_campus %} en cualquier momento yendo al [sitio web de {% data variables.product.prodname_education %}](https://education.github.com). +As a faculty member at an accredited educational institution, you can apply for {% data variables.product.prodname_global_campus %}, which includes {% data variables.product.prodname_education %} benefits and resources. For more information, see "[Apply to {% data variables.product.prodname_global_campus %} as a teacher](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)." -![Portal del {% data variables.product.prodname_global_campus %} para los profesores](/assets/images/help/education/global-campus-portal-teachers.png) +{% data variables.product.prodname_global_campus %} is a portal that allows the GitHub Education Community to access their education benefits, all in one place. Once you are a verified {% data variables.product.prodname_global_campus %} teacher, you can access {% data variables.product.prodname_global_campus %} anytime by going to the [{% data variables.product.prodname_education %} website](https://education.github.com). -Antes de solicitar un descuento individual, compruebe si la comunidad de aprendizaje ya está asociada con nosotros como escuela de {% data variables.product.prodname_campus_program %}. Para más información, vea "[Acerca de {% data variables.product.prodname_campus_program %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-github-campus-program)". +![{% data variables.product.prodname_global_campus %} portal for teachers](/assets/images/help/education/global-campus-portal-teachers.png) -## Características del {% data variables.product.prodname_global_campus %} para los profesores +Before applying for an individual discount, check if your learning community is already partnered with us as a {% data variables.product.prodname_campus_program %} school. For more information, see "[About {% data variables.product.prodname_campus_program %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-github-campus-program)." -{% data variables.product.prodname_global_campus %} es un portal desde el que puedes acceder a tus ventajas y a los recursos de {% data variables.product.prodname_education %}, todo en un solo lugar. En el portal del {% data variables.product.prodname_global_campus %}, los profesores de todos los niveles pueden: {% data reusables.education.apply-for-team %} - - Ver información general sobre tus [{% data variables.product.prodname_classroom %}](https://classroom.github.com), incluidas las asignaciones recientes y el progreso de la clase de un vistazo, así como vínculos a {% data variables.product.prodname_classroom %}. - - Consultar e interactuar con las [{% data variables.product.prodname_discussions %}](https://github.com/orgs/community/discussions/categories/github-education) publicadas por sus compañeros de todo el mundo para analizar las tendencias actuales en la educación tecnológica, y encuentra las entradas más recientes de nuestro [blog {% data variables.product.prodname_education %}](https://github.blog/category/education/). - - Consultar los eventos de los alumnos mantenidos por {% data variables.product.prodname_education %} y los líderes de los alumnos. - - Mantenerte al corriente de lo que interesa a la comunidad de alumnos con los episodios recientes de [Campus TV](https://www.twitch.tv/githubeducation). Campus TV está creado por {% data variables.product.prodname_dotcom %} y por los líderes de la comunidad de alumnos y se puede ver en vivo o a petición. - - Solicite una bolsa de productos de {% data variables.product.prodname_dotcom %} con materiales educativos y productos para los alumnos. +## {% data variables.product.prodname_global_campus %} features for teachers -Hay disponible una suscripción gratuita de {% data variables.product.prodname_copilot %} para profesores verificados con {% data variables.product.prodname_education %}. Recibirás una notificación automática sobre la suscripción gratuita cuando visites la página de suscripción de {% data variables.product.prodname_copilot %} en la configuración de la cuenta. Para obtener más información sobre la suscripción a {% data variables.product.prodname_copilot %} y su uso, consulta "[Administración de la suscripción de {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)" y "[Acerca de {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)". +{% data variables.product.prodname_global_campus %} is a portal from which you can access your {% data variables.product.prodname_education %} benefits and resources, all in one place. On the {% data variables.product.prodname_global_campus %} portal, teachers of all levels can: + {% data reusables.education.apply-for-team %} + - View an overview of your active [{% data variables.product.prodname_classroom %}](https://classroom.github.com), including recent assignments and your class's progress at a glance, as well as links to {% data variables.product.prodname_classroom %}. + - View and interact with [{% data variables.product.prodname_discussions %}](https://github.com/orgs/community/discussions/categories/github-education) posted by your peers from around the world to discuss current trends in technology education, and see the latest posts from our [{% data variables.product.prodname_education %} blog](https://github.blog/category/education/). + - See student events curated by {% data variables.product.prodname_education %} and student leaders. + - Stay in the know on what the student community is interested in by rewatching recent [Campus TV](https://www.twitch.tv/githubeducation) episodes. Campus TV is created by {% data variables.product.prodname_dotcom %} and student community leaders and can be watched live or on demand. + - Request a {% data variables.product.prodname_dotcom %} swag bag with educational materials and goodies for your students. -## Información adicional +A free subscription for {% data variables.product.prodname_copilot %} is available to verified teachers with {% data variables.product.prodname_education %}. You will be automatically notified about the free subscription when you visit the {% data variables.product.prodname_copilot %} subscription page in your account settings. For more information about subscribing to and using {% data variables.product.prodname_copilot %}, see "[Managing your {% data variables.product.prodname_copilot_for_individuals %} subscription](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-for-individuals-subscription#setting-up-a-trial-of-github-copilot)" and "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." -- «[Acerca del {% data variables.product.prodname_global_campus %} para los alumnos](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students)» +## Further reading + +- "[About {% data variables.product.prodname_global_campus %} for students](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students)" diff --git a/translations/es-ES/content/packages/learn-github-packages/about-permissions-for-github-packages.md b/translations/es-ES/content/packages/learn-github-packages/about-permissions-for-github-packages.md index 8d4025e3d694..2f7d1ff02a5b 100644 --- a/translations/es-ES/content/packages/learn-github-packages/about-permissions-for-github-packages.md +++ b/translations/es-ES/content/packages/learn-github-packages/about-permissions-for-github-packages.md @@ -10,31 +10,40 @@ versions: shortTitle: About permissions --- -{% ifversion fpt or ghec %} -The permissions for packages are either repository-scoped or user/organization-scoped. -{% endif %} +{% ifversion packages-registries-v2 %} +The permissions for packages can be scoped either to a user or an organization or to a repository. -## Permissions for repository-scoped packages +## Granular permissions for user/organization-scoped packages -A repository-scoped package inherits the permissions and visibility of the repository that owns the package. You can find a package scoped to a repository by going to the main page of the repository and clicking the **Packages** link to the right of the page. {% ifversion fpt or ghec %}For more information, see "[Connecting a repository to a package](/packages/learn-github-packages/connecting-a-repository-to-a-package)."{% endif %} +Packages with granular permissions are scoped to a personal user or organization account. You can change the access control and visibility of the package separately from a repository that is connected (or linked) to a package. -The {% data variables.product.prodname_registry %} registries below **only** use repository-scoped permissions: +The following {% data variables.product.prodname_registry %} registries support granular permissions. - {% ifversion not fpt or ghec %}- Docker registry (`docker.pkg.github.com`){% endif %} - {% ifversion packages-npm-v2 %}{% else %}- npm registry{% endif %} - - RubyGems registry - - Apache Maven registry - - NuGet registry +- {% data variables.product.prodname_container_registry %} +{% ifversion packages-npm-v2 %}- npm registry{% endif %} +{% ifversion packages-nuget-v2 %}- NuGet registry{% endif %} -{% ifversion packages-npm-v2 %}For {% data variables.packages.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} +{% endif %} -{% ifversion fpt or ghec %} -## Granular permissions for user/organization-scoped packages +## Permissions for {% ifversion packages-registries-v2 %}repository-scoped {% endif %}packages -Packages with granular permissions are scoped to a personal user or organization account. You can change the access control and visibility of the package separately from a repository that is connected (or linked) to a package. +A {% ifversion packages-registries-v2 %}repository-scoped {% endif %}package inherits the permissions and visibility of the repository that owns the package. You can find a package scoped to a repository by going to the main page of the repository and clicking the **Packages** link to the right of the page. {% ifversion fpt or ghec %}For more information, see "[Connecting a repository to a package](/packages/learn-github-packages/connecting-a-repository-to-a-package)."{% endif %} + +{% ifversion packages-registries-v2 %} +The following {% data variables.product.prodname_registry %} registries **only** support repository-scoped permissions. -Currently, the {% data variables.packages.prodname_ghcr_and_npm_registry %} offer granular permissions for your container image packages. +{% ifversion not fpt or ghec %}- Docker registry (`docker.pkg.github.com`){% endif %} +{% ifversion packages-npm-v2 %}{% else %}- npm registry{% endif %} +- RubyGems registry +- Apache Maven registry +- Gradle registry +{% ifversion packages-nuget-v2 %}{% else %}- NuGet registry{% endif %} + +For {% ifversion ghes %}the {% data variables.product.prodname_container_registry %}{% else %}other registries{% endif %}, you can choose to allow packages to be scoped to a user or an organization, or linked to a repository. {% ifversion docker-ghcr-enterprise-migration %}For information about migration to the {% data variables.product.prodname_container_registry %}, see "[Migrating to the {% data variables.product.prodname_container_registry %} from the Docker registry](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)."{% endif %} + +{% endif %} +{% ifversion packages-registries-v2 %} ## Visibility and access permissions for container images {% data reusables.package_registry.visibility-and-access-permissions %} diff --git a/translations/es-ES/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md b/translations/es-ES/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md index 3e7204200c1c..e6a18a925fda 100644 --- a/translations/es-ES/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md +++ b/translations/es-ES/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md @@ -11,18 +11,22 @@ versions: ghes: '*' shortTitle: Access control & visibility --- -{% data reusables.package_registry.container-registry-ghes-beta %} +{% data reusables.package_registry.container-registry-ghes-beta %}{% ifversion packages-registries-v2 %} Packages with granular permissions are scoped to a personal user or organization account. You can change the access control and visibility of a package separately from the repository that it is connected (or linked) to. -Currently, you can only use granular permissions with the {% data variables.packages.prodname_ghcr_and_npm_registry %}. Granular permissions are not supported in our other package registries, such as the RubyGems registry.{% ifversion docker-ghcr-enterprise-migration %} For more information about migration to the {% data variables.product.prodname_container_registry %}, see "[Migrating to the {% data variables.product.prodname_container_registry %} from the Docker registry](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)."{% endif %} +Some registries only support repository-scoped permissions. For the list of these registries, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)." -For more information about permissions for repository-scoped packages, packages-related scopes for PATs, or managing permissions for your actions workflows, see "[About permissions for GitHub Packages](/packages/learn-github-packages/about-permissions-for-github-packages)." +{% else %}A package inherits the permissions and visibility of the repository that owns the package.{% endif %} For more information about permissions for packages, packages-related scopes for PATs, or managing permissions for your actions workflows, see "[About permissions for GitHub Packages](/packages/learn-github-packages/about-permissions-for-github-packages)." + +{% ifversion packages-registries-v2 %} ## Visibility and access permissions for container images {% data reusables.package_registry.visibility-and-access-permissions %} +{% endif %} + ## Configuring access to container images for your personal account If you have admin permissions to a container image that's owned by a personal account, you can assign read, write, or admin roles to other users. For more information about these permission roles, see "[Visibility and access permissions for container images](#visibility-and-access-permissions-for-container-images)." @@ -105,7 +109,7 @@ To further customize access to your container image, see "[Configuring access to {% ifversion fpt or ghec %} ## Ensuring {% data variables.product.prodname_github_codespaces %} access to your package -By default, a codespace can seamlessly access certain packages in the {% data variables.packages.prodname_ghcr_and_npm_registry %}, such as those published in the same repository with the **Inherit access** option selected. For more information on which access is automatically configured, see "[Allowing your codespace to access a private image registry](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry#accessing-images-stored-in-container-registry-and-npm-registry)." +By default, a codespace can seamlessly access certain packages in registries that support granular permissions, such as packages published in the same repository with the **Inherit access** option selected. For the list of {% data variables.product.prodname_registry %} registries that support granular permissions and seamless {% data variables.product.prodname_github_codespaces %} access, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages#granular-permissions-for-userorganization-scoped-packages)." Otherwise, to ensure that a codespace has access to your package, you must grant access to the repository where the codespace is being launched. diff --git a/translations/es-ES/content/packages/learn-github-packages/deleting-and-restoring-a-package.md b/translations/es-ES/content/packages/learn-github-packages/deleting-and-restoring-a-package.md index cb8b157547de..8210f8a2e72e 100644 --- a/translations/es-ES/content/packages/learn-github-packages/deleting-and-restoring-a-package.md +++ b/translations/es-ES/content/packages/learn-github-packages/deleting-and-restoring-a-package.md @@ -37,7 +37,6 @@ On {% data variables.product.prodname_dotcom %}, you can also restore an entire - You restore the package within 30 days of its deletion. - The same package namespace is still available and not used for a new package. -{% ifversion fpt or ghec or ghes %} ## Packages API support {% data reusables.package_registry.packages-classic-pat-only %} @@ -48,35 +47,30 @@ You can use the REST API to manage your packages. For more information, see the {% endif %} -For packages that inherit their permissions and access from repositories, you can use GraphQL to delete a specific package version.{% data reusables.package_registry.no-graphql-to-delete-packages %} For more information about GraphQL support, see "[Deleting a version of a repository-scoped package with GraphQL](#deleting-a-version-of-a-repository-scoped-package-with-graphql)." - -{% endif %} +{% data reusables.package_registry.about-graphql-support %} ## Required permissions to delete or restore a package -For packages that inherit their access permissions from repositories, you can delete a package if you have admin permissions to the repository. +{% ifversion packages-registries-v2 %} +With registries that support granular permissions, you can choose to allow packages to be scoped to a user or an organization, or linked to a repository. -The {% data variables.product.prodname_registry %} registries below **only** use repository-scoped permissions: +To delete a package that has granular permissions separate from a repository, such as container images stored at {% ifversion ghes %}`https://containers.HOSTNAME/OWNER/PACKAGE-NAME`{% else %}`https://ghcr.io/OWNER/PACKAGE-NAME`{% endif %}{% ifversion packages-npm-v2 %} or packages stored at `https://npm.pkg.github.com/OWNER/PACKAGE-NAME`{% endif %}, you must have admin access to the package. For more information, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages)." - {% ifversion not fpt or ghec %}- Docker images at `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`{% endif %} - {% ifversion packages-npm-v2 %}{% else %}- npm{% endif %} - - RubyGems registry - - Apache Maven registry - - NuGet registry +For packages that inherit their access permissions from repositories, you can delete a package if you have admin permissions to the repository. -{% ifversion packages-npm-v2 %}For {% data variables.packages.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} +Some registries **only** support repository-scoped packages. For a list of these registries, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)." -{% ifversion fpt or ghec %} +{% else %} -To delete a package that has granular permissions separate from a repository, such as container images stored at `https://ghcr.io/OWNER/PACKAGE-NAME` or `https://npm.pkg.github.com/OWNER/PACKAGE-NAME`, you must have admin access to the package. For more information, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages)." +You can delete a package if you have admin permissions to the repository to which the package is published. {% endif %} ## Deleting a package version -### Deleting a version of a repository-scoped package on {% data variables.product.prodname_dotcom %} +### Deleting a version of a {% ifversion packages-registries-v2 %}repository-scoped {% endif %}package on {% data variables.product.prodname_dotcom %} -To delete a version of a repository-scoped package, you must have admin permissions to the repository that owns the package. For more information, see "[Required permissions](#required-permissions-to-delete-or-restore-a-package)." +To delete a version of a {% ifversion packages-registries-v2 %}repository-scoped {% endif %}package, you must have admin permissions to the repository that owns the package. For more information, see "[Required permissions](#required-permissions-to-delete-or-restore-a-package)." {% data reusables.repositories.navigate-to-repo %} {% data reusables.package_registry.packages-from-code-tab %} @@ -88,11 +82,9 @@ To delete a version of a repository-scoped package, you must have admin permissi ![Confirm package deletion button](/assets/images/help/package-registry/package-version-deletion-confirmation.png) {% ifversion fpt or ghec or ghes %} -### Deleting a version of a repository-scoped package with GraphQL - -For packages that inherit their permissions and access from repositories, you can use the GraphQL to delete a specific package version. +### Deleting a version of a {% ifversion packages-registries-v2 %}repository-scoped{% endif %} package with GraphQL -{% data reusables.package_registry.no-graphql-to-delete-packages %}{% ifversion fpt or ghec %} You can however use the REST API. For more information, see the "[{% data variables.product.prodname_registry %} API](/rest/reference/packages)."{% endif %} +{% data reusables.package_registry.about-graphql-support %}{% ifversion fpt or ghec %} For information on using the REST API instead, see the "[{% data variables.product.prodname_registry %} API](/rest/reference/packages)."{% endif %} Use the `deletePackageVersion` mutation in the GraphQL API. You must use a {% data variables.product.pat_v1 %} with the `read:packages`, `delete:packages`, and `repo` scopes. For more information about {% data variables.product.pat_v1_plural %}, see "[About {% data variables.product.prodname_registry %}](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)." diff --git a/translations/es-ES/content/packages/learn-github-packages/introduction-to-github-packages.md b/translations/es-ES/content/packages/learn-github-packages/introduction-to-github-packages.md index 4537c6fe1de9..158c0805c5df 100644 --- a/translations/es-ES/content/packages/learn-github-packages/introduction-to-github-packages.md +++ b/translations/es-ES/content/packages/learn-github-packages/introduction-to-github-packages.md @@ -51,11 +51,9 @@ For more information about the configuration of {% data variables.product.prodna | | | |--------------------|--------------------| -| Permissions | {% ifversion fpt or ghec %}The permissions for a package are either inherited from the repository where the package is hosted or, for packages in the {% data variables.packages.prodname_ghcr_and_npm_registry %}, they can be defined for specific user or organization accounts. For more information, see "[Configuring a package’s access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)." {% else %}Each package inherits the permissions of the repository where the package is hosted.

For example, anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version.{% endif %} | +| Permissions | {% ifversion packages-registries-v2 %}The permissions for a package are either inherited from the repository where the package is hosted, or can be defined for specific user or organization accounts. Some registries only support permissions inherited from a repository. For a list of these registries, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)." For more information on package access, see "[Configuring a package’s access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)." {% else %}Each package inherits the permissions of the repository where the package is hosted.

For example, anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version.{% endif %} | | Visibility | {% data reusables.package_registry.public-or-private-packages %} | -For more information, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages)." - {% ifversion fpt or ghec %} ## About billing for {% data variables.product.prodname_registry %} @@ -100,19 +98,7 @@ For more information about Docker and the {% data variables.product.prodname_con ## Managing packages -{% ifversion fpt or ghec %} -You can delete a package in the {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %} user interface or using the REST API. For more information, see "[Deleting and restoring a package](/packages/learn-github-packages/deleting-and-restoring-a-package)" and the "[{% data variables.product.prodname_registry %} API](/rest/reference/packages)." - -{% data reusables.package_registry.no-graphql-to-delete-packages %} -{% endif %} - -{% ifversion ghes %} -You can delete a private or public package in the {% data variables.product.product_name %} user interface. Or for repo-scoped packages, you can delete a version of a private package using GraphQL. -{% endif %} - -{% ifversion ghae %} -You can delete a version of a package in the {% data variables.product.product_name %} user interface or using the GraphQL API. -{% endif %} +You can delete a package in the {% data variables.product.product_name %} user interface{% ifversion fpt or ghec %} or using the REST API. For more information, see "[Deleting and restoring a package](/packages/learn-github-packages/deleting-and-restoring-a-package)" and the "[{% data variables.product.prodname_registry %} API](/rest/reference/packages)."{% else %}.{% endif %} {% data reusables.package_registry.about-graphql-support %} When you use the GraphQL API to query and delete private packages, you must use the same {% data variables.product.pat_v1 %} you use to authenticate to {% data variables.product.prodname_registry %}. diff --git a/translations/es-ES/content/packages/learn-github-packages/viewing-packages.md b/translations/es-ES/content/packages/learn-github-packages/viewing-packages.md index 3c239df022f6..6dfa628822c2 100644 --- a/translations/es-ES/content/packages/learn-github-packages/viewing-packages.md +++ b/translations/es-ES/content/packages/learn-github-packages/viewing-packages.md @@ -23,18 +23,16 @@ versions: Your ability to view a package depends on several factors. By default, you can view all packages you have published. -Repository-scoped packages inherit their permissions and visibility from the repository that owns the package. The registries below **only** use this type of permissions:{% ifversion not fpt or ghec %} -- Docker registry (`docker.pkg.github.com`){% endif %} -{% ifversion packages-npm-v2 %}{% else %}- npm registry{% endif %} -- RubyGems registry -- Apache Maven registry -- NuGet registry - -{% ifversion fpt or ghec %} -The {% data variables.packages.prodname_ghcr_and_npm_registry %} offer you the option of granular permissions and visibility settings that can be customized for each package owned by a personal user or organization account. You can choose to use granular permissions or connect the package to a repository and inherit it's permissions. For more information, see "[Connecting a repository to a package](/packages/learn-github-packages/connecting-a-repository-to-a-package)." -{% endif %} +{% ifversion packages-registries-v2 %} +Repository-scoped packages inherit their permissions and visibility from the repository that owns the package. Some registries **only** support repository-scoped packages. For a list of these registries, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)." + +Other registries offer you the option of granular permissions and visibility settings that can be customized for each package owned by a personal user or organization account. You can choose to use granular permissions or connect the package to a repository and inherit the repository's permissions. For more information, see "[Connecting a repository to a package](/packages/learn-github-packages/connecting-a-repository-to-a-package)" and "[Configuring a package's access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)." + +{% else %} -For more information, see "[About permissions for GitHub Packages](/packages/learn-github-packages/about-permissions-for-github-packages){% ifversion fpt or ghec %}" and "[Configuring a package's access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility){% endif %}." +Packages inherit their permissions and visibility from the repository on which they are hosted. For more information, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages)." + +{% endif %} {% data reusables.package_registry.package-page-info %} diff --git a/translations/es-ES/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md b/translations/es-ES/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md index a4dbfcc69ac9..f0aa8e04e7ec 100644 --- a/translations/es-ES/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md +++ b/translations/es-ES/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md @@ -23,37 +23,40 @@ shortTitle: Publish & install with Actions You can extend the CI and CD capabilities of your repository by publishing or installing packages as part of your workflow. -{% ifversion fpt or ghec %} -### Authenticating to the {% data variables.packages.prodname_ghcr_and_npm_registry %} +{% ifversion packages-registries-v2 %} +### Authenticating to package registries with granular permissions {% data reusables.package_registry.authenticate_with_pat_for_v2_registry %} +### Authenticating to package registries with repository-scoped permissions + {% endif %} -### Authenticating to package registries on {% data variables.product.prodname_dotcom %} +{% ifversion packages-registries-v2 %}Some {% data variables.product.prodname_registry %} registries only support repository-scoped permissions, and do not support granular permissions. For a list of these registries, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)." -{% ifversion fpt or ghec %}If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access a package registry other than the {% data variables.product.prodname_container_registry %} on {% data variables.location.product_location %}, then{% else %}To authenticate to package registries on {% data variables.product.product_name %},{% endif %} we recommend using the `GITHUB_TOKEN` that {% data variables.product.product_name %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %} instead of a {% data variables.product.pat_generic %} for authentication. You should set the permissions for this access token in the workflow file to grant read access for the `contents` scope and write access for the `packages` scope. For forks, the `GITHUB_TOKEN` is granted read access for the parent repository. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." +If you want your workflow to access a {% data variables.product.prodname_registry %} registry that does not support granular permissions, then{% else %}To authenticate to package registries on {% data variables.product.product_name %},{% endif %} we recommend using the `GITHUB_TOKEN` that {% data variables.product.product_name %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %}. You should set the permissions for this access token in the workflow file to grant read access for the `contents` scope and write access for the `packages` scope. For forks, the `GITHUB_TOKEN` is granted read access for the parent repository. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." You can reference the `GITHUB_TOKEN` in your workflow file using the {% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %} context. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)." -## About permissions and package access for repository-owned packages +## About permissions and package access -{% note %} +{% ifversion packages-registries-v2 %} -**Note:** Some registries, such as RubyGems, {% ifversion packages-npm-v2 %}{% else %}npm, {% endif %}Apache Maven, NuGet, {% ifversion fpt or ghec %}and Gradle{% else %}Gradle, and Docker packages that use the package namespace `docker.pkg.github.com`{% endif %}, only allow repository-owned packages. With {% data variables.packages.prodname_ghcr_and_npm_registry_full %} you can choose to allow packages to be owned by a user, an organization, or linked to a repository. +### Packages scoped to users or organizations -{% endnote %} +Registries that support granular permissions allow users to create and administer packages as free-standing resources at the organization level. Packages can be owned by an organization or personal account and you can customize access to each of your packages separately from repository permissions. -When you enable GitHub Actions, GitHub installs a GitHub App on your repository. The `GITHUB_TOKEN` secret is a GitHub App installation access token. You can use the installation access token to authenticate on behalf of the GitHub App installed on your repository. The token's permissions are limited to the repository that contains your workflow. For more information, see "[Permissions for the GITHUB_TOKEN](/actions/reference/authentication-in-a-workflow#about-the-github_token-secret)." +All workflows accessing registries that support granular permissions should use the `GITHUB_TOKEN` instead of a {% data variables.product.pat_generic %}. For more information about security best practices, see "[Security hardening for GitHub Actions](/actions/learn-github-actions/security-hardening-for-github-actions#using-secrets)." -{% data variables.product.prodname_registry %} allows you to push and pull packages through the `GITHUB_TOKEN` available to a {% data variables.product.prodname_actions %} workflow. +### Packages scoped to repositories -{% ifversion fpt or ghec %} -## About permissions and package access for {% data variables.packages.prodname_ghcr_and_npm_registry %} +{% endif %} -The {% data variables.packages.prodname_ghcr_and_npm_registry_full %} allows users to create and administer packages as free-standing resources at the organization level. Packages can be owned by an organization or personal account and you can customize access to each of your packages separately from repository permissions. +When you enable GitHub Actions, GitHub installs a GitHub App on your repository. The `GITHUB_TOKEN` secret is a GitHub App installation access token. You can use the installation access token to authenticate on behalf of the GitHub App installed on your repository. The token's permissions are limited to the repository that contains your workflow. For more information, see "[Permissions for the GITHUB_TOKEN](/actions/reference/authentication-in-a-workflow#about-the-github_token-secret)." -All workflows accessing the {% data variables.packages.prodname_ghcr_and_npm_registry %} should use the `GITHUB_TOKEN` instead of a {% data variables.product.pat_generic %}. For more information about security best practices, see "[Security hardening for GitHub Actions](/actions/learn-github-actions/security-hardening-for-github-actions#using-secrets)." +{% data variables.product.prodname_registry %} allows you to push and pull packages through the `GITHUB_TOKEN` available to a {% data variables.product.prodname_actions %} workflow. + +{% ifversion packages-registries-v2 %} ## Default permissions and access settings for containers modified through workflows @@ -483,14 +486,14 @@ Installing packages hosted by {% data variables.product.prodname_registry %} thr {% data reusables.package_registry.actions-configuration %} -{% ifversion fpt or ghec %} +{% ifversion packages-registries-v2 %} ## Upgrading a workflow that accesses a registry using a {% data variables.product.pat_generic %} -The {% data variables.packages.prodname_ghcr_and_npm_registry %} support the `GITHUB_TOKEN` for easy and secure authentication in your workflows. If your workflow is using a {% data variables.product.pat_generic %} to authenticate to the registry, then we highly recommend you update your workflow to use the `GITHUB_TOKEN`. +{% data variables.product.prodname_registry %} supports the `GITHUB_TOKEN` for easy and secure authentication in your workflows. If you're using a registry that supports granular permissions, and your workflow is using a {% data variables.product.pat_generic %} to authenticate to the registry, then we highly recommend you update your workflow to use the `GITHUB_TOKEN`. For more information about the `GITHUB_TOKEN`, see "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow#using-the-github_token-in-a-workflow)." -Using the `GITHUB_TOKEN` instead of a {% data variables.product.pat_v1 %}, which includes the `repo` scope, increases the security of your repository as you don't need to use a long-lived {% data variables.product.pat_generic %} that offers unnecessary access to the repository where your workflow is run. For more information about security best practices, see "[Security hardening for GitHub Actions](/actions/learn-github-actions/security-hardening-for-github-actions#using-secrets)." +Using the `GITHUB_TOKEN`, instead of a {% data variables.product.pat_v1 %} with the `repo` scope, increases the security of your repository as you don't need to use a long-lived {% data variables.product.pat_generic %} that offers unnecessary access to the repository where your workflow is run. For more information about security best practices, see "[Security hardening for GitHub Actions](/actions/learn-github-actions/security-hardening-for-github-actions#using-secrets)." 1. Navigate to your package landing page. 1. In the left sidebar, click **Actions access**. diff --git a/translations/es-ES/content/packages/working-with-a-github-packages-registry/working-with-the-npm-registry.md b/translations/es-ES/content/packages/working-with-a-github-packages-registry/working-with-the-npm-registry.md index b90b8ff549a7..09d4236c63b9 100644 --- a/translations/es-ES/content/packages/working-with-a-github-packages-registry/working-with-the-npm-registry.md +++ b/translations/es-ES/content/packages/working-with-a-github-packages-registry/working-with-the-npm-registry.md @@ -103,22 +103,16 @@ $ npm login --scope=@OWNER --registry=https://HOSTNAME/_registry/npm/ {% ifversion packages-npm-v2 %} The {% data variables.product.prodname_registry %} registry stores npm packages within your organization or personal account, and allows you to associate a package with a repository. You can choose whether to inherit permissions from a repository, or set granular permissions independently of a repository. + +{% data reusables.package_registry.publishing-user-scoped-packages %} {% endif %} By default, {% data variables.product.prodname_registry %} publishes a package in the {% data variables.product.prodname_dotcom %} repository you specify in the name field of the *package.json* file. For example, you would publish a package named `@my-org/test` to the `my-org/test` {% data variables.product.prodname_dotcom %} repository. If you're running [npm v8.5.3](https://github.com/npm/cli/releases/tag/v8.5.3) or later, you can add a summary for the package listing page by including a *README.md* file in your package directory. For more information, see "[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" and "[How to create Node.js Modules](https://docs.npmjs.com/getting-started/creating-node-modules)" in the npm documentation. You can publish multiple packages to the same {% data variables.product.prodname_dotcom %} repository by including a `URL` field in the *package.json* file. For more information, see "[Publishing multiple packages to the same repository](#publishing-multiple-packages-to-the-same-repository)." -{% ifversion fpt or ghec %} -When a package is published, it isn't automatically linked to a repository. You can however choose to link your published package to a repository using the user interface or command line. For more information, see "[Connecting a repository to a package](/packages/learn-github-packages/connecting-a-repository-to-a-package)." -{% endif %} - You can set up the scope mapping for your project using either a local *.npmrc* file in the project or using the `publishConfig` option in the *package.json*. {% data variables.product.prodname_registry %} only supports scoped npm packages. Scoped packages have names with the format of `@owner/name`. Scoped packages always begin with an `@` symbol. You may need to update the name in your *package.json* to use the scoped name. For example, `"name": "@codertocat/hello-world-npm"`. -{% ifversion packages-npm-v2 %} -When you first publish a package, the default visibility is private. When a package is linked to repository, the package visibility is dependent on the repository's visibility. To change the visibility or set access permissions, see "[Configuring a package's access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)." -{% endif %} - {% data reusables.package_registry.viewing-packages %} ### Publishing a package using a local *.npmrc* file diff --git a/translations/es-ES/content/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.md b/translations/es-ES/content/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.md index 9e13e1e527f8..b071df613def 100644 --- a/translations/es-ES/content/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.md +++ b/translations/es-ES/content/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.md @@ -26,6 +26,10 @@ shortTitle: NuGet registry {% data reusables.package_registry.authenticate-packages %} +{% ifversion packages-nuget-v2 %} +You can choose to give access permissions to packages independently for {% data variables.product.prodname_github_codespaces %} and {% data variables.product.prodname_actions %}. For more information, see "[Ensuring Codespaces access to your package](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-codespaces-access-to-your-package)" and "[Ensuring workflow access to your package](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package)." +{% endif %} + ### Authenticating with `GITHUB_TOKEN` in {% data variables.product.prodname_actions %} Use the following command to authenticate to {% data variables.product.prodname_registry %} in a {% data variables.product.prodname_actions %} workflow using the `GITHUB_TOKEN` instead of hardcoding a {% data variables.product.pat_generic %} in a nuget.config file in the repository: @@ -45,7 +49,7 @@ To authenticate to {% data variables.product.prodname_registry %} with the `dotn You must replace: - `USERNAME` with the name of your personal account on {% data variables.product.prodname_dotcom %}. - `TOKEN` with your {% data variables.product.pat_v1 %}. -- `OWNER` with the name of the user or organization account that owns the repository containing your project.{% ifversion ghes or ghae %} +- `OWNER` with the name of the user or organization account that owns {% ifversion packages-nuget-v2 %}the package you want to install, or to which you want to publish a package{% else %}the repository containing your project{% endif %}.{% ifversion ghes or ghae %} - `HOSTNAME` with the host name for {% data variables.location.product_location %}.{% endif %} {% ifversion ghes %}If your instance has subdomain isolation enabled: @@ -91,6 +95,16 @@ If your instance has subdomain isolation disabled: You can publish a package to {% data variables.product.prodname_registry %} by authenticating with a *nuget.config* file, or by using the `--api-key` command line option with your {% data variables.product.prodname_dotcom %} {% data variables.product.pat_v1 %}. +{% ifversion packages-nuget-v2 %} + +The NuGet registry stores packages within your organization or personal account, and allows you to associate packages with a repository. You can choose whether to inherit permissions from a repository, or set granular permissions independently of a repository. + +{% data reusables.package_registry.publishing-user-scoped-packages %} + +If you specify a `RepositoryURL` in your `nuget.config` file, the published package will automatically be connected to the specified repository. For more information, see "[Publishing a package using a `nuget.config` file](/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry#publishing-a-package-using-a-nugetconfig-file)." For information on linking an already-published package to a repository, see "[Connecting a repository to a package](/packages/learn-github-packages/connecting-a-repository-to-a-package)." + +{% endif %} + ### Publishing a package using a GitHub {% data variables.product.pat_generic %} as your API key If you don't already have a PAT to use for your account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}, see "[Creating a {% data variables.product.pat_generic %}](/github/authenticating-to-github/creating-a-personal-access-token)." @@ -121,8 +135,8 @@ When publishing, you need to use the same value for `OWNER` in your *csproj* fil dotnet new console --name OctocatApp ``` 3. Add your project's specific information to your project's file, which ends in *.csproj*. You must replace: - - `OWNER` with the name of the user or organization account that owns the repository containing your project. - - `REPOSITORY` with the name of the repository containing the package you want to publish. + - `OWNER` with the name of the user or organization account that owns the repository to which you want to connect your package. + - `REPOSITORY` with the name of the repository to which you want to connect your package. - `1.0.0` with the version number of the package.{% ifversion ghes or ghae %} - `HOSTNAME` with the host name for {% data variables.location.product_location %}.{% endif %} ``` xml @@ -155,7 +169,7 @@ When publishing, you need to use the same value for `OWNER` in your *csproj* fil ## Publishing multiple packages to the same repository -To publish multiple packages to the same repository, you can include the same {% data variables.product.prodname_dotcom %} repository URL in the `RepositoryURL` fields in all *.csproj* project files. {% data variables.product.prodname_dotcom %} matches the repository based on that field. +To connect multiple packages to the same repository, you can include the same {% data variables.product.prodname_dotcom %} repository URL in the `RepositoryURL` fields in all *.csproj* project files. {% data variables.product.prodname_dotcom %} matches the repository based on that field. For example, the *OctodogApp* and *OctocatApp* projects will publish to the same repository: diff --git a/translations/es-ES/content/rest/packages.md b/translations/es-ES/content/rest/packages.md index 9388be2f7f1e..9290fde114ba 100644 --- a/translations/es-ES/content/rest/packages.md +++ b/translations/es-ES/content/rest/packages.md @@ -20,6 +20,6 @@ To use this API, you must authenticate using a {% data variables.product.pat_v1 - To delete packages and package versions, your token must include the `read:packages` and `delete:packages` scopes. - To restore packages and package versions, your token must include the `read:packages` and `write:packages` scopes. -If your `package_type` is `npm`, `maven`, `rubygems`, or `nuget`, then your token must also include the `repo` scope since your package inherits permissions from a {% data variables.product.prodname_dotcom %} repository. If your package is in the {% data variables.product.prodname_container_registry %}, then your `package_type` is `container` and your token does not need the `repo` scope to access or manage this `package_type`. `container` packages offer granular permissions separate from a repository. For more information, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages#about-scopes-and-permissions-for-package-registries)." +If your package is in a registry that supports granular permissions, then your token does not need the `repo` scope to access or manage this package. If your package is in a registry that only supports repository-scoped permissions, then your token must also include the `repo` scope since your package inherits permissions from a {% data variables.product.prodname_dotcom %} repository. For a list of registries that only support repository-scoped permissions, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)." If you want to use the {% data variables.product.prodname_registry %} API to access resources in an organization with SSO enabled, then you must enable SSO for your {% data variables.product.pat_v1 %}. For more information, see "[Authorizing a {% data variables.product.pat_generic %} for use with SAML single sign-on](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %} diff --git a/translations/es-ES/content/site-policy/privacy-policies/index.md b/translations/es-ES/content/site-policy/privacy-policies/index.md index 216cc64c188f..f6f980b92585 100644 --- a/translations/es-ES/content/site-policy/privacy-policies/index.md +++ b/translations/es-ES/content/site-policy/privacy-policies/index.md @@ -11,6 +11,7 @@ children: - /github-subprocessors-and-cookies - /github-codespaces-privacy-statement - /github-candidate-privacy-policy + - /github-copilot-for-business-privacy-statement ms.openlocfilehash: 4c10c47e44eca61e42528fef7c90d010fd8196f0 ms.sourcegitcommit: 93b306112b5cd5ce482d468a25c9961ad02f87ac ms.translationtype: HT diff --git a/translations/es-ES/data/reusables/copilot/copilot-prerequisites.md b/translations/es-ES/data/reusables/copilot/copilot-prerequisites.md index 50ea6ccb71d3..474fc8b7fa34 100644 --- a/translations/es-ES/data/reusables/copilot/copilot-prerequisites.md +++ b/translations/es-ES/data/reusables/copilot/copilot-prerequisites.md @@ -1,10 +1,2 @@ ---- -ms.openlocfilehash: 65ef5b7ddead68864d8890f47e1ec5e8163a368b -ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/11/2022 -ms.locfileid: "147881952" ---- -- {% data variables.product.prodname_copilot %} es gratuito para los alumnos verificados y los responsables de mantener el código abierto. -- Si no eres alumno ni mantenedor de código abierto, puedes probar {% data variables.product.prodname_copilot %} de manera gratuita con una prueba de 60 días. Después de la evaluación gratuita, necesitarás una suscripción de pago para continuar usándolo. Debes proporcionar información de facturación para iniciar una evaluación gratuita. Para obtener más información, consulta "[Acerca de la facturación de {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)". +- {% data variables.product.prodname_copilot %} is free to use for verified students, teachers, and open source maintainers. +- If you are not a student, teacher, or open source maintainer, you will need an active trial or subscription. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)." diff --git a/translations/es-ES/data/reusables/copilot/dotcom-settings.md b/translations/es-ES/data/reusables/copilot/dotcom-settings.md index dd1d635dd051..6f4ce4255600 100644 --- a/translations/es-ES/data/reusables/copilot/dotcom-settings.md +++ b/translations/es-ES/data/reusables/copilot/dotcom-settings.md @@ -1,31 +1,31 @@ ---- -ms.openlocfilehash: 224ce401421d3af0e9afa5976695c95ed219a7b5 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109938" ---- -## Configuración de los valores de {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_dotcom_the_website %} +## Configuring {% data variables.product.prodname_copilot %} settings on {% data variables.product.prodname_dotcom_the_website %} -Una vez que tenga una suscripción o prueba de {% data variables.product.prodname_copilot %} activa, puede ajustar la configuración de {% data variables.product.prodname_copilot %} para su cuenta personal en {% data variables.product.prodname_dotcom %} en la [configuración de {% data variables.product.prodname_copilot %}](https://github.com/settings/copilot). La configuración se aplica en cualquier lugar en el que se usen los datos {% data variables.product.prodname_copilot %}. Se pueden configurar las sugerencias que ofrece {% data variables.product.prodname_copilot %} y cómo {% data variables.product.company_short %} usa los datos de telemetría. +Once you have an active {% data variables.product.prodname_copilot %} trial or subscription, you can adjust {% data variables.product.prodname_copilot %} settings for your personal account on {% data variables.product.prodname_dotcom %} in the [{% data variables.product.prodname_copilot %} settings](https://github.com/settings/copilot). The settings apply anywhere that you use {% data variables.product.prodname_copilot %}. You can configure the suggestions that {% data variables.product.prodname_copilot %} offers and how {% data variables.product.company_short %} uses your telemetry data. -## Habilitación o deshabilitación de la detección de duplicación +### Enabling or disabling duplication detection -En {% data variables.product.prodname_copilot %} se incluye un filtro que detecta sugerencias de código que coinciden con el código público en {% data variables.product.prodname_dotcom %}. Puedes optar por habilitar o deshabilitar el filtro. Cuando el filtro está habilitado, {% data variables.product.prodname_copilot %} comprueba las sugerencias de código con su código circundante de aproximadamente 150 caracteres en el código público de los datos {% data variables.product.prodname_dotcom %}. Si hay una coincidencia o una coincidencia aproximada, la sugerencia no se mostrará. +{% data reusables.copilot.duplication-setting-org %} -{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.copilot-settings %} -1. En **Sugerencias que coinciden con código público**, selecciona el menú desplegable y, después, haz clic en **Permitir** para permitir sugerencias que coincidan con código público o **Bloquear** para bloquear la coincidencia de sugerencias con código público. - ![Captura de pantalla de la opción](/assets/images/help/copilot/duplication-detection.png) de detección de duplicación {% data reusables.copilot.save-settings %} +{% data variables.product.prodname_copilot %} includes a filter which detects code suggestions matching public code on {% data variables.product.prodname_dotcom %}. You can choose to enable or disable the filter. When the filter is enabled, {% data variables.product.prodname_copilot %} checks code suggestions with their surrounding code of about 150 characters against public code on {% data variables.product.prodname_dotcom %}. If there is a match or near match, the suggestion will not be shown to you. -## Habilitación o deshabilitación de telemetría +{% data reusables.user-settings.access_settings %} +{% data reusables.user-settings.copilot-settings %} +1. Under **Suggestions matching public code**, select the dropdown menu, then click **Allow** to allow suggestions matching public code, or **Block** to block suggestions matching public code. + ![Screenshot of duplication detection option](/assets/images/help/copilot/duplication-detection.png) +{% data reusables.copilot.save-settings %} -Puedes elegir si GitHub recopila y conserva los fragmentos de código y los procesa y comparte con Microsoft y OpenAI si ajustas la configuración de usuario. Para más información sobre los datos que {% data variables.product.prodname_copilot %} puede recopilar en función de la configuración de telemetría, consulta "[Condiciones de {% data variables.product.company_short %} para características y productos adicionales](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)" y las [Preguntas más frecuentes de privacidad de {% data variables.product.prodname_copilot %}](https://github.com/features/copilot/#faq-privacy). +### Enabling or disabling telemetry -{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.copilot-settings %} -1. Para permitir o evitar que los datos {% data variables.product.prodname_dotcom %} usen los datos de telemetría, seleccione o anule la selección de **Permitir que {% data variables.product.prodname_dotcom %} use mis fragmentos de código para mejorar el producto**. - ![Captura de pantalla de la opción](/assets/images/help/copilot/telemetry-option.png) de telemetría {% data reusables.copilot.save-settings %} +{% data reusables.copilot.telemetry-setting-org %} -## Información adicional +You can choose whether your code snippets are collected and retained by GitHub and further processed and shared with Microsoft and OpenAI by adjusting your user settings. For more information about data that {% data variables.product.prodname_copilot %} may collect depending on your telemetry settings, see "[{% data variables.product.company_short %} Terms for Additional Products and Features](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)" and the [{% data variables.product.prodname_copilot %} privacy FAQ](https://github.com/features/copilot/#faq-privacy). -- [Preguntas más frecuentes de {% data variables.product.prodname_copilot %}](https://github.com/features/copilot/#faq) +{% data reusables.user-settings.access_settings %} +{% data reusables.user-settings.copilot-settings %} +1. To allow or prevent {% data variables.product.prodname_dotcom %} using your telemetry data, select or deselect **Allow {% data variables.product.prodname_dotcom %} to use my code snippets for product improvements**. + ![Screenshot of telemetry option](/assets/images/help/copilot/telemetry-option.png) +{% data reusables.copilot.save-settings %} + +## Further reading + +- [{% data variables.product.prodname_copilot %} FAQ](https://github.com/features/copilot/#faq) diff --git a/translations/es-ES/data/reusables/gated-features/copilot-billing.md b/translations/es-ES/data/reusables/gated-features/copilot-billing.md index 40bcdfa7b952..3c0855422141 100644 --- a/translations/es-ES/data/reusables/gated-features/copilot-billing.md +++ b/translations/es-ES/data/reusables/gated-features/copilot-billing.md @@ -1,9 +1,3 @@ ---- -ms.openlocfilehash: ed3544608134084a2a11c5db9e9c474b29c14e41 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109981" ---- -Actualmente, la facturación de {% data variables.product.prodname_copilot %} solo se puede administrar mediante cuentas personales. Las organizaciones no pueden administrar la facturación de {% data variables.product.prodname_copilot %} para los miembros de la organización en este momento. Si estás interesado en administrar la facturación de {% data variables.product.prodname_copilot %} mediante tu organización, puedes unirte a la [lista de espera](https://github.com/features/copilot/org_signup). +{% data variables.product.prodname_copilot %} can be managed through personal accounts with {% data variables.product.prodname_copilot_for_individuals %} or through invoiced {% data variables.product.prodname_ghe_cloud %} accounts with {% data variables.product.prodname_copilot_for_business %}.

+ +{% data variables.product.prodname_ghe_cloud %} accounts paying through credit card or PayPal, and organizations on the {% data variables.product.prodname_team %} or {% data variables.product.prodname_free_team %} plans cannot manage {% data variables.product.prodname_copilot %} for their members at this time. If you are interested in managing {% data variables.product.prodname_copilot %} through your {% data variables.product.prodname_ghe_cloud %} account paying through credit card or PayPal, or your organization on the {% data variables.product.prodname_team %} or {% data variables.product.prodname_free_team %} plan, you can contact sales and request to join the [waitlist](https://github.com/enterprise/contact?ref_page=/pricing?_features=site_copilot_biz_ga&ref_cta=Contact%20Sales&ref_loc=cards). diff --git a/translations/es-ES/data/reusables/gated-features/copilot.md b/translations/es-ES/data/reusables/gated-features/copilot.md index e37a345d741c..6181711a83dc 100644 --- a/translations/es-ES/data/reusables/gated-features/copilot.md +++ b/translations/es-ES/data/reusables/gated-features/copilot.md @@ -1,11 +1,3 @@ ---- -ms.openlocfilehash: c408676063e80cca29eb7392181c00c4ecf7f76d -ms.sourcegitcommit: d82f268a6f0236d1f4d2bf3d049974ada0170402 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/10/2022 -ms.locfileid: "148160785" ---- -{% data variables.product.prodname_copilot %} está disponible para los clientes de {% data variables.product.company_short %} con una cuenta personal en {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.copilot.emus-cannot-use-copilot %}

+{% data variables.product.prodname_copilot %} is available to {% data variables.product.company_short %} customers with a personal account on {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.prodname_ghe_cloud %} organizations owned by an enterprise account.

-{% data variables.product.prodname_copilot %} es gratis para los alumnos comprobados, profesores y los mantenedores de proyectos populares de código abierto. Si no eres alumno, profesor, ni mantenedor de un proyecto popular de código abierto, puedes probar {% data variables.product.prodname_copilot %} de manera gratuita con una prueba de 60 días. Después de la evaluación gratuita, necesitarás una suscripción de pago para continuar usándolo. Para más información, consulta "[Acerca de la configuración de {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)". +{% data variables.product.prodname_copilot %} is free to use for verified students, teachers, and maintainers of popular open source projects. If you are not a student, teacher, or maintainer of a popular open source project, you can try {% data variables.product.prodname_copilot %} for free with a one-time 60-day trial. After the free trial, you will need a paid subscription for continued use. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)." diff --git a/translations/es-ES/data/reusables/package_registry/authenticate_with_pat_for_v2_registry.md b/translations/es-ES/data/reusables/package_registry/authenticate_with_pat_for_v2_registry.md index 01895299f1fe..74c99daf2769 100644 --- a/translations/es-ES/data/reusables/package_registry/authenticate_with_pat_for_v2_registry.md +++ b/translations/es-ES/data/reusables/package_registry/authenticate_with_pat_for_v2_registry.md @@ -1,15 +1,9 @@ ---- -ms.openlocfilehash: 902af6bdbe3c48fe8b5930bdf1041151f343b60b -ms.sourcegitcommit: 27882d9b3f19979c817c25952a2fb4dc4c6f0a65 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/27/2022 -ms.locfileid: "148113869" ---- -Si en el flujo de trabajo se usa un {% data variables.product.pat_generic %} para autenticarse en un registro, se recomienda encarecidamente actualizar el flujo de trabajo para usar el `GITHUB_TOKEN`. +Some {% data variables.product.prodname_registry %} registries support granular permissions. This means you can choose to allow packages to be owned by a user or an organization, or linked to a repository. For the list of registries that support granular permissions, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages#granular-permissions-for-userorganization-scoped-packages)." -{% ifversion fpt or ghec %} Para instrucciones sobre cómo actualizar los flujos de trabajo que se autentican en un registro con un {% data variables.product.pat_generic %}, consulta "[Actualización de un flujo de trabajo que accede a un registro mediante un {% data variables.product.pat_generic %}](/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions#upgrading-a-workflow-that-accesses-a-registry-using-a-personal-access-token)". {% endif %} +For registries that support granular permissions, if your workflow is using a {% data variables.product.pat_generic %} to authenticate to a registry, then we highly recommend you update your workflow to use the `GITHUB_TOKEN`. -Para más información sobre `GITHUB_TOKEN`, vea "[Autenticación en un flujo de trabajo](/actions/reference/authentication-in-a-workflow#using-the-github_token-in-a-workflow)". +For guidance on updating your workflows that authenticate to a registry with a {% data variables.product.pat_generic %}, see "[Upgrading a workflow that accesses a registry using a {% data variables.product.pat_generic %}](/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions#upgrading-a-workflow-that-accesses-a-registry-using-a-personal-access-token)." -Para obtener más información sobre los procedimientos recomendados al usar un registro en acciones, consulta "[Fortalecimiento de seguridad para Acciones de GitHub](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)". +For more information about the `GITHUB_TOKEN`, see "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow#using-the-github_token-in-a-workflow)." + +For more information about the best practices when using a registry in actions, see "[Security hardening for GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)." diff --git a/translations/es-ES/data/reusables/package_registry/no-graphql-to-delete-packages.md b/translations/es-ES/data/reusables/package_registry/no-graphql-to-delete-packages.md index 6a2ec58eddb0..cb0fceb232d0 100644 --- a/translations/es-ES/data/reusables/package_registry/no-graphql-to-delete-packages.md +++ b/translations/es-ES/data/reusables/package_registry/no-graphql-to-delete-packages.md @@ -1,9 +1,3 @@ ---- -ms.openlocfilehash: 5f35d3186458109231db91e80343bcb64a2193c1 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109853" ---- -{% ifversion fpt or ghec %} La API de GraphQL de {% data variables.product.prodname_registry %} no admite contenedores ni imágenes de Docker que usan el espacio de nombres del paquete `https://ghcr.io/OWNER/PACKAGE-NAME` ni imágenes npm que usan el espacio de nombres del paquete `https://npm.pkg.github.com/OWNER/PACKAGE-NAME`.{% endif %} +{% ifversion packages-registries-v2 %} +You cannot use the {% data variables.product.prodname_registry %} GraphQL API with registries that support granular permissions. For the registries that **only** support repository-scoped permissions, and can be used with the GraphQL API, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)." +{% endif %} \ No newline at end of file diff --git a/translations/es-ES/data/reusables/saml/saml-ghes-account-revocation.md b/translations/es-ES/data/reusables/saml/saml-ghes-account-revocation.md index b8f9b51640f2..626efe3f3228 100644 --- a/translations/es-ES/data/reusables/saml/saml-ghes-account-revocation.md +++ b/translations/es-ES/data/reusables/saml/saml-ghes-account-revocation.md @@ -1,13 +1,5 @@ ---- -ms.openlocfilehash: d08df6f87611aec73985fd0ecd279b67079e2a1f -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147067382" ---- {% ifversion ghes %} -Si eliminas un usuario desde tu proveedor de identidades, también debes suspenderlos de forma manual. De lo contrario, el propietario de la cuenta puede seguir autenticando mediante tokens de acceso o claves SSH. Para obtener más información, consulte "[Suspensión y anulación de la suspensión de usuarios](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users)". +With JIT provisioning, if you remove a user from your IdP, you must also manually suspend the user's account on {% data variables.location.product_location %}. Otherwise, the account's owner can continue to authenticate using access tokens or SSH keys. For more information, see "[Suspending and unsuspending users](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users)". {% endif %} diff --git a/translations/es-ES/data/reusables/scim/after-you-configure-saml.md b/translations/es-ES/data/reusables/scim/after-you-configure-saml.md index 21b1b99dd701..e307c57fdfc2 100644 --- a/translations/es-ES/data/reusables/scim/after-you-configure-saml.md +++ b/translations/es-ES/data/reusables/scim/after-you-configure-saml.md @@ -1,9 +1,3 @@ ---- -ms.openlocfilehash: cfe1441d8807b616dae5499c5f1fb01316364c5b -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: "145134509" ---- -Predeterminadamente, tus IdP no se comunican con {% data variables.product.product_name %} automáticamente cuando asignas o desasignas la aplicación. {% data variables.product.product_name %} {% ifversion fpt or ghec %}aprovisiona el acceso a los recursos en {% else %}crea una cuenta de usuario {% endif %}mediante aprovisionamiento Just-in-Time (JIT) de SAML la primera vez que alguien navega a {% ifversion fpt or ghec %}los recursos en {% endif %} {% data variables.product.product_name %} e inicia sesión mediante la autenticación con el IdP. Es posible que tenga que notificar manualmente a los usuarios cuando les conceda acceso a {% data variables.product.product_name %} y {% ifversion fpt or ghec %}desaprovisionar manualmente el acceso {% else %}desactivar la cuenta del usuario en {% endif %}{% data variables.product.product_name %} durante la retirada. Puedes usar SCIM para {% ifversion ghec %}aprovisionar o desaprovisionar{% elsif ghae %}crear o suspender el{% endif %} {% ifversion fpt or ghec %}acceso a las organizaciones propiedad de la empresa en las cuentas de usuario de {% data variables.product.prodname_dotcom_the_website %} {% else %} y el acceso a {% data variables.product.product_name %} {% endif %}de forma automática cuando asigne o anule la asignación de la aplicación en IdP. +By default, your IdP does not communicate with {% data variables.product.product_name %} automatically when you assign or unassign the application. {% data variables.product.product_name %} {% ifversion fpt or ghec %}provisions access to your resources on {% else %}creates a user account {% endif %}using SAML Just-in-Time (JIT) provisioning the first time someone navigates to {% ifversion fpt or ghec %}your resources on {% endif %} {% data variables.product.product_name %} and signs in by authenticating through your IdP. You may need to manually notify users when you grant access to {% data variables.product.product_name %}, and you must manually {% ifversion fpt or ghec %}deprovision access {% else %}deactivate the user account on {% endif %}{% data variables.product.product_name %} during offboarding. + +Alternatively, instead of SAML JIT provisioning, you can use SCIM to {% ifversion ghec %}provision or deprovision{% elsif ghae or scim-for-ghes %}create or suspend{% endif %} {% ifversion fpt or ghec %}access to organizations owned by your enterprise on {% data variables.product.prodname_dotcom_the_website %} {% else %}user accounts and grant or deny access to {% data variables.location.product_location %} {% endif %}automatically after you assign or unassign the application on your IdP.{% ifversion scim-for-ghes %} SCIM for {% data variables.product.product_name %} is currently in private beta and is subject to change.{% endif %} diff --git a/translations/es-ES/data/reusables/scim/ghes-scim-idp-table.md b/translations/es-ES/data/reusables/scim/ghes-scim-idp-table.md index 7b6992a824cc..0e7f4baf3c22 100644 --- a/translations/es-ES/data/reusables/scim/ghes-scim-idp-table.md +++ b/translations/es-ES/data/reusables/scim/ghes-scim-idp-table.md @@ -1,16 +1,7 @@ ---- -ms.openlocfilehash: ef572fed8832a5c236badbd14c6a3921ea49c5e9 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109992" ---- {% ifversion scim-for-ghes %} -IdP | SAML | Aprovisionamiento de usuarios | Mapeo de equipo| +IdP | SAML | User provisioning | Team mapping| --- | --- | ---------------- | --------- | [Azure Active Directory (Azure AD)](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad) | {% octicon "check-circle-fill" aria-label="The check icon" %} | {% octicon "check-circle-fill" aria-label="The check icon" %}| {% octicon "check-circle-fill" aria-label="The check icon" %} | -[Okta](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-okta) | {% octicon "check-circle-fill" aria-label="The check icon" %} | {% octicon "check-circle-fill" aria-label="The check icon" %} | {% octicon "check-circle-fill" aria-label= "The check icon" %} | {% endif %} \ No newline at end of file diff --git a/translations/es-ES/data/variables/product.yml b/translations/es-ES/data/variables/product.yml index 4b90a74a9dab..28190383b259 100644 --- a/translations/es-ES/data/variables/product.yml +++ b/translations/es-ES/data/variables/product.yml @@ -223,6 +223,10 @@ prodname_arctic_vault: 'Arctic Code Vault' # GitHub Copilot prodname_copilot: 'GitHub Copilot' prodname_copilot_short: 'Copilot' +prodname_copilot_for_business: 'GitHub Copilot for Business' +prodname_copilot_for_individuals: 'GitHub Copilot for Individuals' +prodname_copilot_business_short: 'Copilot for Business' +prodname_copilot_individuals_short: 'Copilot for Individuals' # Command Palette prodname_command_palette: 'GitHub Command Palette' diff --git a/translations/log/msft-es-resets.csv b/translations/log/msft-es-resets.csv index 3e094a58dd56..5206d0560366 100644 --- a/translations/log/msft-es-resets.csv +++ b/translations/log/msft-es-resets.csv @@ -79,6 +79,7 @@ translations/es-ES/content/billing/managing-billing-for-github-codespaces/about- translations/es-ES/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces.md,file deleted because it no longer exists in main translations/es-ES/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md,file deleted because it no longer exists in main translations/es-ES/content/billing/managing-billing-for-github-codespaces/viewing-your-codespaces-usage.md,file deleted because it no longer exists in main +translations/es-ES/content/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription.md,file deleted because it no longer exists in main translations/es-ES/content/code-security/dependabot/dependabot-alerts/browsing-security-advisories-in-the-github-advisory-database.md,file deleted because it no longer exists in main translations/es-ES/content/code-security/dependabot/dependabot-alerts/browsing-security-vulnerabilities-in-the-github-advisory-database.md,file deleted because it no longer exists in main translations/es-ES/content/code-security/dependabot/dependabot-alerts/editing-security-advisories-in-the-github-advisory-database.md,file deleted because it no longer exists in main @@ -95,6 +96,7 @@ translations/es-ES/content/code-security/repository-security-advisories/publishi translations/es-ES/content/code-security/repository-security-advisories/removing-a-collaborator-from-a-repository-security-advisory.md,file deleted because it no longer exists in main translations/es-ES/content/code-security/repository-security-advisories/withdrawing-a-repository-security-advisory.md,file deleted because it no longer exists in main translations/es-ES/content/code-security/security-advisories/repository-security-advisories/about-coordinated-disclosure-of-security-vulnerabilities.md,file deleted because it no longer exists in main +translations/es-ES/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/codespaces-reference/disaster-recovery-for-codespaces.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/codespaces-reference/security-in-codespaces.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/codespaces-reference/understanding-billing-for-codespaces.md,file deleted because it no longer exists in main @@ -588,6 +590,10 @@ translations/es-ES/content/admin/enterprise-management/updating-the-virtual-mach translations/es-ES/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md,rendering error translations/es-ES/content/admin/github-actions/advanced-configuration-and-troubleshooting/troubleshooting-github-actions-for-your-enterprise.md,rendering error translations/es-ES/content/admin/github-actions/advanced-configuration-and-troubleshooting/using-a-staging-environment.md,broken liquid tags +translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-amazon-s3-storage.md,broken liquid tags +translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-azure-blob-storage.md,broken liquid tags +translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-google-cloud-storage.md,broken liquid tags +translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md,broken liquid tags translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates.md,rendering error translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises.md,rendering error translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md,rendering error @@ -604,11 +610,16 @@ translations/es-ES/content/admin/identity-and-access-management/using-built-in-a translations/es-ES/content/admin/identity-and-access-management/using-built-in-authentication/inviting-people-to-use-your-instance.md,broken liquid tags translations/es-ES/content/admin/identity-and-access-management/using-cas-for-enterprise-iam/index.md,broken liquid tags translations/es-ES/content/admin/identity-and-access-management/using-cas-for-enterprise-iam/using-cas.md,broken liquid tags +translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md,broken liquid tags translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users.md,rendering error translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users.md,rendering error translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-scim-provisioning-for-enterprise-managed-users.md,rendering error translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc.md,rendering error translations/es-ES/content/admin/identity-and-access-management/using-ldap-for-enterprise-iam/index.md,broken liquid tags +translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md,broken liquid tags +translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md,broken liquid tags +translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-okta.md,broken liquid tags +translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise.md,broken liquid tags translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/enabling-encrypted-assertions.md,broken liquid tags translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference.md,broken liquid tags translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account.md,broken liquid tags @@ -686,7 +697,7 @@ translations/es-ES/content/authentication/troubleshooting-ssh/recovering-your-ss translations/es-ES/content/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security.md,broken liquid tags translations/es-ES/content/billing/managing-billing-for-github-advanced-security/viewing-your-github-advanced-security-usage.md,rendering error translations/es-ES/content/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot.md,broken liquid tags -translations/es-ES/content/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription.md,broken liquid tags +translations/es-ES/content/billing/managing-billing-for-github-copilot/index.md,broken liquid tags translations/es-ES/content/billing/managing-billing-for-github-packages/about-billing-for-github-packages.md,rendering error translations/es-ES/content/billing/managing-billing-for-your-github-account/about-billing-for-your-enterprise.md,broken liquid tags translations/es-ES/content/billing/managing-billing-for-your-github-account/about-per-user-pricing.md,rendering error @@ -761,6 +772,14 @@ translations/es-ES/content/communities/documenting-your-project-with-wikis/editi translations/es-ES/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-personal-account.md,rendering error translations/es-ES/content/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file.md,broken liquid tags translations/es-ES/content/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors.md,broken liquid tags +translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-in-a-jetbrains-ide.md,broken liquid tags +translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-in-visual-studio-code.md,broken liquid tags +translations/es-ES/content/copilot/configuring-github-copilot/configuring-github-copilot-settings-on-githubcom.md,broken liquid tags +translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md,broken liquid tags +translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-neovim.md,broken liquid tags +translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md,broken liquid tags +translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md,broken liquid tags +translations/es-ES/content/copilot/overview-of-github-copilot/about-github-copilot.md,broken liquid tags translations/es-ES/content/copilot/quickstart.md,broken liquid tags translations/es-ES/content/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop.md,broken liquid tags translations/es-ES/content/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/index.md,broken liquid tags @@ -784,6 +803,8 @@ translations/es-ES/content/discussions/collaborating-with-your-community-using-d translations/es-ES/content/discussions/guides/finding-your-discussions.md,broken liquid tags translations/es-ES/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions.md,broken liquid tags translations/es-ES/content/discussions/managing-discussions-for-your-community/moderating-discussions.md,rendering error +translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md,broken liquid tags +translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md,broken liquid tags translations/es-ES/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/glossary.md,broken liquid tags translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/about-using-makecode-arcade-with-github-classroom.md,broken liquid tags translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/integrate-github-classroom-with-an-ide.md,broken liquid tags @@ -1052,6 +1073,8 @@ translations/es-ES/data/reusables/codespaces/next-steps-adding-devcontainer.md,b translations/es-ES/data/reusables/codespaces/prebuilds-crossreference.md,broken liquid tags translations/es-ES/data/reusables/codespaces/secrets-on-start.md,broken liquid tags translations/es-ES/data/reusables/command_line/provide-an-access-token.md,broken liquid tags +translations/es-ES/data/reusables/copilot/copilot-prerequisites.md,broken liquid tags +translations/es-ES/data/reusables/copilot/dotcom-settings.md,broken liquid tags translations/es-ES/data/reusables/copilot/install-copilot-in-neovim.md,broken liquid tags translations/es-ES/data/reusables/dependabot/beta-security-and-version-updates.md,rendering error translations/es-ES/data/reusables/dependabot/default-dependencies-allow-ignore.md,broken liquid tags @@ -1096,6 +1119,8 @@ translations/es-ES/data/reusables/enterprise_user_management/consider-usernames- translations/es-ES/data/reusables/enterprise_user_management/disclaimer-for-git-read-access.md,broken liquid tags translations/es-ES/data/reusables/files/choose-commit-email.md,broken liquid tags translations/es-ES/data/reusables/gated-features/codespaces-classroom-articles.md,broken liquid tags +translations/es-ES/data/reusables/gated-features/copilot-billing.md,broken liquid tags +translations/es-ES/data/reusables/gated-features/copilot.md,broken liquid tags translations/es-ES/data/reusables/gated-features/dependency-vulnerable-calls.md,rendering error translations/es-ES/data/reusables/gated-features/secret-scanning-partner.md,rendering error translations/es-ES/data/reusables/gated-features/secret-scanning.md,rendering error @@ -1126,7 +1151,9 @@ translations/es-ES/data/reusables/organizations/teams_sidebar.md,rendering error translations/es-ES/data/reusables/organizations/verified-domains.md,rendering error translations/es-ES/data/reusables/package_registry/authenticate-packages.md,broken liquid tags translations/es-ES/data/reusables/package_registry/authenticate-to-container-registry-steps.md,rendering error +translations/es-ES/data/reusables/package_registry/authenticate_with_pat_for_v2_registry.md,broken liquid tags translations/es-ES/data/reusables/package_registry/next-steps-for-packages-enterprise-setup.md,broken liquid tags +translations/es-ES/data/reusables/package_registry/no-graphql-to-delete-packages.md,broken liquid tags translations/es-ES/data/reusables/package_registry/package-registry-with-github-tokens.md,broken liquid tags translations/es-ES/data/reusables/package_registry/packages-billing.md,broken liquid tags translations/es-ES/data/reusables/package_registry/required-scopes.md,broken liquid tags @@ -1158,8 +1185,11 @@ translations/es-ES/data/reusables/saml/about-linked-identities.md,broken liquid translations/es-ES/data/reusables/saml/about-saml-access-enterprise-account.md,broken liquid tags translations/es-ES/data/reusables/saml/authorized-creds-info.md,broken liquid tags translations/es-ES/data/reusables/saml/must-authorize-linked-identity.md,broken liquid tags +translations/es-ES/data/reusables/saml/saml-ghes-account-revocation.md,broken liquid tags translations/es-ES/data/reusables/saml/you-must-periodically-authenticate.md,broken liquid tags +translations/es-ES/data/reusables/scim/after-you-configure-saml.md,broken liquid tags translations/es-ES/data/reusables/scim/enterprise-account-scim.md,broken liquid tags +translations/es-ES/data/reusables/scim/ghes-scim-idp-table.md,broken liquid tags translations/es-ES/data/reusables/scim/supported-idps.md,broken liquid tags translations/es-ES/data/reusables/search/syntax_tips.md,broken liquid tags translations/es-ES/data/reusables/secret-scanning/enterprise-enable-secret-scanning.md,broken liquid tags