> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ottieni un profilo di sicurezza dell'org

> Recupera uno dei profili di sicurezza di proprietà dell'organizzazione tramite il suo ID.

Restituisce uno dei profili di sicurezza propri dell'organizzazione. I profili condivisi a livello Enterprise non vengono restituiti da questo endpoint.

Consulta [Profili di sicurezza](https://docs.devinenterprise.com/it/product-guides/security-profiles.md) per scoprire l'effetto di ciascuna restrizione e come vengono determinati i profili.

## Autorizzazioni

Richiede un [utente di servizio](https://docs.devinenterprise.com/it/api-reference/v3/service-users/members-service-users.md) o un [token di accesso personale](https://docs.devinenterprise.com/it/api-reference/personal-access-tokens.md) con l'autorizzazione `ManageSecureModeProfiles` a livello di organizzazione. I token usati da una sessione Devin in esecuzione vengono rifiutati, così una sessione non può modificare i profili che ne regolano il comportamento.


## OpenAPI

````yaml it/v3-openapi.yaml GET /v3beta1/organizations/{org_id}/security-profiles/{profile_id}
openapi: 3.1.0
info:
  description: API Devin v3 con autenticazione utente di servizio e RBAC
  title: Devin API v3
  version: 3.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v3beta1/organizations/{org_id}/security-profiles/{profile_id}:
    get:
      tags:
        - security-profiles
      summary: Ottieni un profilo di sicurezza dell'org
      description: >-
        Recupera uno dei profili di sicurezza di proprietà dell'organizzazione
        tramite il suo ID.
      operationId: >-
        handle_get_security_profile_v3beta1_organizations__org_id__security_profiles__profile_id__get
      parameters:
        - in: path
          name: profile_id
          required: true
          schema:
            title: Profile Id
            type: string
        - description: 'ID dell''organizzazione (prefisso: org-)'
          in: path
          name: org_id
          required: true
          schema:
            example: org-abc123def456
            title: Org Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecurityProfileResponse'
          description: Risposta riuscita
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non autorizzato
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Vietato
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non trovato
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflitto
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non più disponibile
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Contenuto non elaborabile
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Troppe Richieste
components:
  schemas:
    SecurityProfileResponse:
      additionalProperties: false
      description: Un profilo di sicurezza di proprietà dell'organizzazione.
      properties:
        created_at:
          title: Created At
          type: integer
        devin_mcp_read_only:
          description: >-
            Se true, le sessioni possono chiamare solo strumenti Devin MCP di
            sola lettura (nessuna creazione di sessioni, gestione di automazioni
            o altra operazione di scrittura).
          title: Devin Mcp Read Only
          type: boolean
        enforcement_level:
          description: >-
            i profili consigliati possono essere sovrascritti dalle associazioni
            dei livelli inferiori; i profili obbligatori impongono restrizioni
            minime che le policy dei livelli inferiori possono solo rendere più
            rigide.
          enum:
            - recommended
            - mandatory
          title: Enforcement Level
          type: string
        git_access_level:
          enum:
            - read_only
            - read_write
          title: Git Access Level
          type: string
        mcp_config:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileMcpConfig'
            - type: 'null'
          description: null = questo profilo non esprime alcuna preferenza su MCP.
        name:
          title: Name
          type: string
        net_policy:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileNetPolicy'
            - type: 'null'
          description: >-
            null = questo profilo non esprime alcuna preferenza sulla rete (NON
            significa bloccare tutto).
        org_id:
          title: Org Id
          type: string
        profile_id:
          description: L'ID del profilo di sicurezza.
          title: Profile Id
          type: string
        remove_github_cli_token:
          description: >-
            Se true, il token della GitHub CLI viene rimosso dalla macchina
            della sessione, impedendo l'accesso diretto all'API di GitHub.
          title: Remove Github Cli Token
          type: boolean
        slack_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileSlackChannelAccess'
            - type: 'null'
          description: >-
            Limite ai canali Slack in cui le sessioni regolate da questo profilo
            possono leggere e pubblicare messaggi. null = questo profilo non
            esprime alcuna preferenza e si applica l'impostazione Slack
            dell'organizzazione.
        slack_dm_scope:
          anyOf:
            - enum:
                - disabled
                - org_members
                - workspace
              type: string
            - type: 'null'
          description: >-
            Limite agli utenti che possono inviare messaggi diretti a Devin su
            Slack con questo profilo. null = questo profilo non esprime alcuna
            preferenza e si applica l'impostazione Slack dell'organizzazione.
            'workspace' viene limitato a 'org_members' per gli account
            enterprise.
          title: Slack Dm Scope
        teams_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileTeamsChannelAccess'
            - type: 'null'
          description: >-
            Limite ai canali Microsoft Teams in cui le sessioni regolate da
            questo profilo possono leggere e pubblicare messaggi. null = questo
            profilo non esprime alcuna preferenza e si applica l'accesso
            predefinito a Teams dell'organizzazione.
        teams_dm_scope:
          anyOf:
            - enum:
                - disabled
                - installed_users
              type: string
            - type: 'null'
          description: >-
            Limite ai destinatari a cui Devin può inviare messaggi diretti su
            Microsoft Teams con questo profilo. null = questo profilo non
            esprime alcuna preferenza e si applica l'accesso predefinito a Teams
            dell'organizzazione.
          title: Teams Dm Scope
        teams_group_chat_scope:
          anyOf:
            - enum:
                - disabled
                - origin_chat
              type: string
            - type: 'null'
          description: >-
            Limite alle chat di gruppo di Teams che Devin può leggere con questo
            profilo; `origin_chat` = solo la chat di gruppo da cui è stata
            avviata la sessione; null = nessuna preferenza, l'accesso deriva
            dall'accesso predefinito a Teams dell'org, come per i messaggi
            diretti.
          title: Teams Group Chat Scope
        updated_at:
          title: Updated At
          type: integer
      required:
        - profile_id
        - name
        - git_access_level
        - enforcement_level
        - devin_mcp_read_only
        - remove_github_cli_token
        - created_at
        - updated_at
        - org_id
      title: SecurityProfileResponse
      type: object
    ProblemDetail:
      description: >-
        Corpo dell'errore application/problem+json RFC 9457 per l'API v3.


        detail è mantenuto dal corpo legacy {"detail": ...} per
        retrocompatibilità; gli

        altri membri sono aggiuntivi. errors contiene gli errori di validazione
        a livello di campo

        (solo 422).
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Una spiegazione leggibile dall'utente, specifica per questa
            occorrenza.
          title: Detail
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Codice elaborabile automaticamente che indica il rifiuto di
            un'azione bloccata (ad es. "user_frozen", "migrated_session").
          title: Error Code
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Errori di convalida a livello di campo (solo per le risposte 422).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Un riferimento URI (il percorso della richiesta) per questa
            occorrenza.
          title: Instance
        status:
          description: Il codice di stato HTTP.
          title: Status
          type: integer
        title:
          description: Un breve riepilogo del tipo di problema, leggibile dall'utente.
          title: Title
          type: string
        type:
          default: about:blank
          description: Un riferimento URI che identifica il tipo di problema.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
    SecurityProfileMcpConfig:
      additionalProperties: false
      properties:
        servers:
          description: >-
            Server MCP che le sessioni regolate da questo profilo possono usare,
            indicizzati per slug: uno slug del marketplace (il campo slug della
            risorsa mcp-servers, ad es. 'github', 'notion') oppure lo slug di
            un'installazione. Quando un'installazione personalizzata condivide
            lo slug con un server del marketplace, prevale l'installazione
            personalizzata.
          items:
            type: string
          title: Servers
          type: array
      required:
        - servers
      title: SecurityProfileMcpConfig
      type: object
    SecurityProfileNetPolicy:
      additionalProperties: false
      properties:
        allow:
          description: >-
            Destinazioni consentite; tutto ciò che non è elencato viene
            bloccato. Le voci relative ai nomi host supportano i caratteri jolly
            (ad es. *.github.com). Un elenco vuoto costituisce una policy valida
            che blocca tutto.
          items:
            anyOf:
              - $ref: '#/components/schemas/SecurityProfileHostnameDestination'
              - $ref: '#/components/schemas/SecurityProfileIpv4Destination'
              - $ref: '#/components/schemas/SecurityProfileIpv6Destination'
          title: Allow
          type: array
      required:
        - allow
      title: SecurityProfileNetPolicy
      type: object
    SecurityProfileSlackChannelAccess:
      additionalProperties: false
      properties:
        channels:
          description: >-
            Canali consentiti quando mode è 'specific'; nelle altre modalità
            vengono ignorati e viene restituito un elenco vuoto.
          items:
            $ref: '#/components/schemas/SecurityProfileSlackChannel'
          title: Channels
          type: array
        mode:
          description: >-
            none = le sessioni non possono leggere né pubblicare in alcun
            canale; specific = solo i canali elencati; all_public = qualsiasi
            canale pubblico di cui l'app Slack è membro.
          enum:
            - none
            - specific
            - all_public
          title: Mode
          type: string
      required:
        - mode
      title: SecurityProfileSlackChannelAccess
      type: object
    SecurityProfileTeamsChannelAccess:
      additionalProperties: false
      properties:
        channels:
          description: >-
            Canali consentiti quando la modalità è 'specific'; per le altre
            modalità vengono ignorati e restituiti come elenco vuoto.
          items:
            $ref: '#/components/schemas/SecurityProfileTeamsChannel'
          title: Channels
          type: array
        mode:
          description: >-
            none = le sessioni non possono leggere né pubblicare in alcun
            canale; specific = solo i canali elencati; installed_teams =
            qualsiasi canale di un team in cui è installata l'app Devin.
          enum:
            - none
            - specific
            - installed_teams
          title: Mode
          type: string
      required:
        - mode
      title: SecurityProfileTeamsChannelAccess
      type: object
    SecurityProfileHostnameDestination:
      additionalProperties: false
      properties:
        hostname:
          title: Hostname
          type: string
      required:
        - hostname
      title: SecurityProfileHostnameDestination
      type: object
    SecurityProfileIpv4Destination:
      additionalProperties: false
      properties:
        ipv4:
          title: Ipv4
          type: string
      required:
        - ipv4
      title: SecurityProfileIpv4Destination
      type: object
    SecurityProfileIpv6Destination:
      additionalProperties: false
      properties:
        ipv6:
          title: Ipv6
          type: string
      required:
        - ipv6
      title: SecurityProfileIpv6Destination
      type: object
    SecurityProfileSlackChannel:
      additionalProperties: false
      properties:
        channel_id:
          description: ID del canale Slack.
          minLength: 1
          title: Channel Id
          type: string
        team_id:
          description: ID del workspace (team) Slack.
          minLength: 1
          title: Team Id
          type: string
      required:
        - team_id
        - channel_id
      title: SecurityProfileSlackChannel
      type: object
    SecurityProfileTeamsChannel:
      additionalProperties: false
      properties:
        channel_id:
          description: ID del canale Teams ('19:...@thread.tacv2').
          minLength: 1
          title: Channel Id
          type: string
        team_id:
          description: ID del gruppo Entra del team Microsoft Teams.
          minLength: 1
          title: Team Id
          type: string
      required:
        - team_id
        - channel_id
      title: SecurityProfileTeamsChannel
      type: object
  securitySchemes:
    bearerAuth:
      description: 'Credenziale dell''utente del servizio (prefisso: cog_)'
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.