|
1 | | -name: "Frogbot Scan Pull Request" |
2 | | -on: |
3 | | - pull_request_target: |
4 | | - types: [opened, synchronize] |
5 | | -permissions: |
6 | | - pull-requests: write |
7 | | - contents: read |
8 | | - # [Mandatory If using OIDC authentication protocol instead of JF_ACCESS_TOKEN] |
9 | | - # id-token: write |
10 | | -jobs: |
11 | | - scan-pull-request: |
12 | | - runs-on: ubuntu-latest |
13 | | - # A pull request needs to be approved before Frogbot scans it. Any GitHub user who is associated with the |
14 | | - # "frogbot" GitHub environment can approve the pull request to be scanned. |
15 | | - environment: frogbot |
16 | | - steps: |
17 | | - - uses: jfrog/frogbot@v2 |
18 | | - env: |
19 | | - # [Mandatory] |
20 | | - # JFrog platform URL |
21 | | - JF_URL: ${{ vars.JF_URL }} |
| 1 | +**The JFrog Security documentation has a new home!**\ |
| 2 | +You can now find it [here](https://jfrog.com/help/p/security-home), including sections on: |
22 | 3 |
|
23 | | - # [Mandatory if JF_USER and JF_PASSWORD are not provided] |
24 | | - # JFrog access token with 'read' permissions on Xray service |
25 | | - JF_ACCESS_TOKEN: ${{ secrets.JF_ACCESS_TOKEN }} |
26 | | - |
27 | | - # [Mandatory if JF_ACCESS_TOKEN is not provided] |
28 | | - # JFrog username with 'read' permissions for Xray. Must be provided with JF_PASSWORD |
29 | | - # JF_USER: ${{ secrets.JF_USER }} |
30 | | - |
31 | | - # [Mandatory if JF_ACCESS_TOKEN is not provided] |
32 | | - # JFrog password. Must be provided with JF_USER |
33 | | - # JF_PASSWORD: ${{ secrets.JF_PASSWORD }} |
34 | | - |
35 | | - # [Mandatory] |
36 | | - # The GitHub token is automatically generated for the job |
37 | | - JF_GIT_TOKEN: ${{ secrets.GITHUB_TOKEN }} |
38 | | - |
39 | | - # [Optional, default: https://api.github.com] |
40 | | - # API endpoint to GitHub |
41 | | - # JF_GIT_API_ENDPOINT: https://github.example.com |
42 | | - |
43 | | - # [Optional] |
44 | | - # By default, the Frogbot workflows download the Frogbot executable as well as other tools |
45 | | - # needed from https://releases.jfrog.io |
46 | | - # If the machine that runs Frogbot has no access to the internet, follow these steps to allow the |
47 | | - # executable to be downloaded from an Artifactory instance, which the machine has access to: |
48 | | - # |
49 | | - # 1. Login to the Artifactory UI, with a user who has admin credentials. |
50 | | - # 2. Create a Remote Repository with the following properties set. |
51 | | - # Under the 'Basic' tab: |
52 | | - # Package Type: Generic |
53 | | - # URL: https://releases.jfrog.io |
54 | | - # Under the 'Advanced' tab: |
55 | | - # Uncheck the 'Store Artifacts Locally' option |
56 | | - # 3. Set the value of the 'JF_RELEASES_REPO' variable with the Repository Key you created. |
57 | | - # JF_RELEASES_REPO: "" |
58 | | - |
59 | | - # [Optional] |
60 | | - # Configure the SMTP server to enable Frogbot to send emails with detected secrets in pull request scans. |
61 | | - # SMTP server URL including should the relevant port: (Example: smtp.server.com:8080) |
62 | | - # JF_SMTP_SERVER: "" |
63 | | - |
64 | | - # [Mandatory if JF_SMTP_SERVER is set] |
65 | | - # The username required for authenticating with the SMTP server. |
66 | | - # JF_SMTP_USER: "" |
67 | | - |
68 | | - # [Mandatory if JF_SMTP_SERVER is set] |
69 | | - # The password associated with the username required for authentication with the SMTP server. |
70 | | - # JF_SMTP_PASSWORD: "" |
71 | | - |
72 | | - ########################################################################## |
73 | | - ## If your project uses a 'frogbot-config.yml' file, you can define ## |
74 | | - ## the following variables inside the file, instead of here. ## |
75 | | - ########################################################################## |
76 | | - |
77 | | - # [Mandatory if the two conditions below are met] |
78 | | - # 1. The project uses yarn 2, NuGet or .NET Core to download its dependencies |
79 | | - # 2. The `installCommand` variable isn't set in your frogbot-config.yml file. |
80 | | - # |
81 | | - # The command that installs the project dependencies (e.g "nuget restore") |
82 | | - # JF_INSTALL_DEPS_CMD: "" |
83 | | - |
84 | | - # [Optional, default: "."] |
85 | | - # Relative path to the root of the project in the Git repository. If left empty (without providing "." yourself as default), a recursive scan is triggered from the root directory of the project. |
86 | | - # JF_WORKING_DIR: path/to/project/dir |
87 | | - |
88 | | - # [Default: "*git*;*node_modules*;*target*;*venv*;*test*"] |
89 | | - # List of exclusion patterns (utilizing wildcards) for excluding paths in the source code of the Git repository during SCA scans. |
90 | | - # JF_PATH_EXCLUSIONS: "*git*;*node_modules*;*target*;*venv*;*test*" |
91 | | - |
92 | | - # [Optional] |
93 | | - # Xray Watches. Learn more about them here: https://www.jfrog.com/confluence/display/JFROG/Configuring+Xray+Watches |
94 | | - # JF_WATCHES: <watch-1>,<watch-2>...<watch-n> |
95 | | - |
96 | | - # [Optional] |
97 | | - # JFrog project. Learn more about it here: https://www.jfrog.com/confluence/display/JFROG/Projects |
98 | | - # JF_PROJECT: <project-key> |
99 | | - |
100 | | - # [Optional, default: "FALSE"] |
101 | | - # Displays all existing vulnerabilities, including the ones that were added by the pull request. |
102 | | - # JF_INCLUDE_ALL_VULNERABILITIES: "TRUE" |
103 | | - |
104 | | - # [Optional, default: "FALSE"] |
105 | | - # When adding new comments on pull requests, keep old comments that were added by previous scans. |
106 | | - # JF_AVOID_PREVIOUS_PR_COMMENTS_DELETION: "TRUE" |
107 | | - |
108 | | - # [Optional, default: "TRUE"] |
109 | | - # Fails the Frogbot task if any security issue is found. |
110 | | - # JF_FAIL: "FALSE" |
111 | | - |
112 | | - # [Optional] |
113 | | - # Frogbot will download the project dependencies if they're not cached locally. To download the |
114 | | - # dependencies from a virtual repository in Artifactory, set the name of the repository. There's no |
115 | | - # need to set this value, if it is set in the frogbot-config.yml file. |
116 | | - # JF_DEPS_REPO: "" |
117 | | - |
118 | | - # [Optional, Default: "FALSE"] |
119 | | - # If TRUE, Frogbot creates a single pull request with all the fixes. |
120 | | - # If false, Frogbot creates a separate pull request for each fix. |
121 | | - # JF_GIT_AGGREGATE_FIXES: "FALSE" |
122 | | - |
123 | | - # [Optional, Default: "FALSE"] |
124 | | - # Handle vulnerabilities with fix versions only |
125 | | - # JF_FIXABLE_ONLY: "TRUE" |
126 | | - |
127 | | - # [Optional] |
128 | | - # Set the minimum severity for vulnerabilities that should be fixed and commented on in pull requests |
129 | | - # The following values are accepted: Low, Medium, High or Critical |
130 | | - # JF_MIN_SEVERITY: "" |
131 | | - |
132 | | - # [Optional] |
133 | | - # List of comma-separated(,) email addresses to receive email notifications about secrets |
134 | | - # detected during pull request scanning. The notification is also sent to the email set |
135 | | - # in the committer git profile regardless of whether this variable is set or not. |
136 | | - # JF_EMAIL_RECEIVERS: "" |
137 | | - |
138 | | - # [Optional] |
139 | | - # Set the list of allowed licenses |
140 | | - # The full list of licenses can be found in: |
141 | | - # https://github.com/jfrog/frogbot/blob/master/docs/licenses.md |
142 | | - # JF_ALLOWED_LICENSES: "MIT, Apache-2.0" |
143 | | - |
144 | | - # [Optional] |
145 | | - # Avoid adding extra info to pull request comments. that isn't related to the scan findings. |
146 | | - # JF_AVOID_EXTRA_MESSAGES: "TRUE" |
147 | | - |
148 | | - # [Optional] |
149 | | - # Add a title to pull request comments generated by Frogbot. |
150 | | - # JF_PR_COMMENT_TITLE: "" |
151 | | - |
152 | | - # [Mandatory if using OIDC authentication protocol instead of JF_ACCESS_TOKEN] |
153 | | - # Insert to oidc-provider-name the 'Provider Name' defined in the OIDC integration configured in the JPD |
154 | | - # with: |
155 | | - # oidc-provider-name: "" |
| 4 | +* [CLI](https://jfrog.com/help/r/jfrog-security-user-guide/developers/cli) |
| 5 | +* [Frogbot](https://jfrog.com/help/r/jfrog-security-user-guide/developers/frogbot) |
| 6 | +* [IDEs](https://jfrog.com/help/r/jfrog-security-user-guide/developers/ides) |
0 commit comments